Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.repeat — ripetere il testo

Il metodo repeat(count) restituisce copie consecutive di una stringa senza modificare l’originale. Un argomento count di tipo Symbol o BigInt causa un TypeError durante la conversione numerica. Se la conversione e il troncamento producono un intero negativo o un infinito di qualsiasi segno, il metodo genera un RangeError.

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

Sintassi

str.repeat(count)

String.prototype.repeat restituisce una stringa contenente count copie del testo, unite senza separatori. L’originale non cambia. Vengono ripetute le unità di codice UTF-16, anziché interpretare separatamente i caratteri visibili.

L’argomento count viene convertito numericamente e troncato verso zero: 2.9 produce due ripetizioni, mentre -0.5 produce una stringa vuota. Anche 0, NaN e l’argomento omesso producono una stringa vuota. Un valore di tipo Symbol o BigInt causa un TypeError durante la conversione numerica. Se la conversione e il troncamento producono un intero negativo, Infinity o -Infinity, il metodo genera un RangeError; questo vale anche con un testo di input vuoto.

Il metodo può essere preso in prestito tramite String.prototype.repeat.call(value, count): il ricevente viene convertito in testo, ma null e undefined causano TypeError. Con dati esterni, limita il numero di ripetizioni per evitare di richiedere un risultato eccessivamente grande.

Esempi

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);
}

Risultato

ababab
""
abab
ab
RangeError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti