Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.repeat — repetir texto

O método repeat(count) devolve cópias consecutivas de uma cadeia de caracteres sem alterar a original. Um argumento count do tipo Symbol ou BigInt provoca um TypeError durante a conversão numérica. Se a conversão e o truncamento produzirem um inteiro negativo ou um infinito de qualquer sinal, o método lança um RangeError.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

str.repeat(count)

String.prototype.repeat devolve uma cadeia de caracteres com count cópias do texto, unidas sem separadores. A original não é alterada. São repetidas unidades de código UTF-16, em vez de os caracteres visíveis serem interpretados separadamente.

O argumento count é convertido numericamente e truncado na direção de zero: 2.9 produz duas repetições, enquanto -0.5 produz uma cadeia vazia. 0, NaN e a omissão do argumento também produzem uma cadeia vazia. Um valor do tipo Symbol ou BigInt provoca um TypeError durante a conversão numérica. Se a conversão e o truncamento produzirem um inteiro negativo, Infinity ou -Infinity, o método lança um RangeError; isto também se aplica a texto de entrada vazio.

O método pode ser utilizado através de String.prototype.repeat.call(value, count): o recetor é convertido em texto, mas null e undefined provocam TypeError. Para dados externos, limite o número de repetições para evitar pedir um resultado excessivamente grande.

Exemplos

const text = "ab";
console.log(text.repeat(3));
console.log(JSON.stringify(text.repeat(0)));
console.log(text.repeat(2.9));
console.log(text);
try {
  text.repeat(-1);
} catch (error) {
  console.log(error.name);
}

Resultado

ababab
""
abab
ab
RangeError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes