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
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
countest 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> |