Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

String : méthode repeat()

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.

La méthode repeat() des valeurs String construit et retourne une nouvelle chaîne de caractères qui contient le nombre de copies défini de cette chaîne de caractères, concaténées ensemble.

Exemple interactif

const mood = "Joyeux ! ";

console.log(`Je me sens ${mood.repeat(3)}`);
// Résultat attendu : "Je me sens Joyeux ! Joyeux ! Joyeux ! "

Syntaxe

js
repeat(count)

Paramètres

count

Un entier entre 0 et Infinity, indiquant le nombre de fois que la chaîne de caractères est répétée.

Valeur de retour

Une nouvelle chaîne de caractères contenant le nombre indiqué de copies de la chaîne de caractère donnée.

Exceptions

RangeError

Levée si count est négatif ou dépasse la longueur maximum.

Exemples

Utiliser la méthode repeat()

js
"abc".repeat(-1); // RangeError
"abc".repeat(0); // ""
"abc".repeat(1); // "abc"
"abc".repeat(2); // "abcabc"
"abc".repeat(3.5); // "abcabcabc" (le compteur est converti en un nombre entier)
"abc".repeat(1 / 0); // RangeError

({ toString: () => "abc", repeat: String.prototype.repeat }).repeat(2);
// "abcabc" (repeat() est une méthode générique)

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-string.prototype.repeat

Compatibilité des navigateurs

Voir aussi