String.prototype.repeat()
Baseline
Widely available
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() construit et renvoie une nouvelle chaine de caractères qui contient le nombre de copie demandée de la chaine de caractères sur laquelle la méthode a été appelée, concaténées les unes aux autres.
Exemple interactif
const mood = "Happy! ";
console.log(`I feel ${mood.repeat(3)}`);
// Expected output: "I feel Happy! Happy! Happy! "
Syntaxe
js
str.repeat(compte);
Paramètres
compte-
Un nombre entier entre 0 and +∞ : [ 0, +∞[, indiquant le nombre de fois que la chaine de caractères doit être repétée dans la nouvelle chaine de caractères.
Valeur de retour
Une nouvelle chaîne de caractères composée du nombre indiqué de copies de la chaîne appelante.
Exceptions
RangeError: le nombre de répétition doit être positif.RangeError: le nombre de répétition ne doit pas être infini et la taille de la chaîne résultante ne doit pas dépasser la taille maximale pour une chaîne de caractères.
RangeError-
La compteur doit être positif et inférieur à l'infini.
Exemples
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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.repeat |