CKTIS / JavaScript
String.prototype.repeat — répéter un texte
La méthode repeat(count) renvoie des copies consécutives d’une chaîne sans modifier l’originale. Un argument count de type Symbol ou BigInt provoque une TypeError lors de la conversion numérique. Si la conversion et la troncature donnent un entier négatif ou une valeur infinie, positive ou négative, la méthode lève une RangeError.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.repeat(count)String.prototype.repeat renvoie une chaîne contenant count copies du texte, concaténées sans séparateur. La chaîne d’origine reste inchangée. La méthode répète les unités de code UTF-16, au lieu d’interpréter séparément les caractères visibles.
L’argument count fait l’objet d’une conversion numérique et d’une troncature vers zéro : 2.9 produit deux répétitions, tandis que -0.5 produit une chaîne vide. 0, NaN et un argument omis produisent également une chaîne vide. Une valeur de type Symbol ou BigInt provoque une TypeError lors de la conversion numérique. Si la conversion et la troncature donnent un entier négatif, Infinity ou -Infinity, la méthode lève une RangeError ; cela vaut aussi pour un texte d’entrée vide.
La méthode peut être empruntée avec String.prototype.repeat.call(value, count) : le récepteur est converti en texte, mais null et undefined provoquent une TypeError. Pour les données externes, limitez le nombre de répétitions afin d’éviter de demander un résultat excessivement volumineux.
Exemples
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);
}Résultat
ababab "" abab ab RangeError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.