CKTIS / JavaScript
String.prototype.replaceAll — remplacer toutes les correspondances
replaceAll remplace chaque correspondance non chevauchante d’une chaîne ou d’une expression régulière globale, sans modifier la chaîne d’origine. Le remplacement peut être du texte ou une fonction.
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
text.replaceAll(searchValue, replaceValue)Avec un motif chaîne, String.prototype.replaceAll renvoie une chaîne dans laquelle chaque correspondance non chevauchante est remplacée de gauche à droite. La chaîne d’origine reste inchangée et le texte inséré n’est pas recherché à nouveau. En l’absence de correspondance, le contenu du résultat reste inchangé. Contrairement à replace avec un motif chaîne, la méthode ne s’arrête pas après la première correspondance.
Un searchValue de type chaîne est interprété littéralement : "." désigne un point, et non n’importe quel caractère. Une expression régulière doit avoir le drapeau g ; son absence provoque une TypeError. Un motif chaîne vide correspond à chaque limite d’unité de code UTF-16, y compris au début et à la fin : "ab".replaceAll("", "-") produit "-a-b-". Un objet doté d’une méthode [Symbol.replace] peut prendre en charge l’opération et en déterminer le résultat.
replaceValue peut être du texte ou une fonction. Dans le texte de remplacement, $$ représente un signe dollar et $& la correspondance ; les expressions régulières prennent aussi en charge les références aux groupes capturés. Pour insérer littéralement du texte dynamique contenant ces séquences, utilisez () => replacement. Avec un motif chaîne, la fonction reçoit (match, offset, string) ; avec une expression régulière, elle reçoit aussi les groupes capturés avant l’offset et, s’il existe des groupes nommés, un objet de groupes nommés à la fin.
Cette méthode fait partie d’ECMAScript 2021, et non des Web APIs. La spécification n’est pas un tableau de compatibilité des navigateurs ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs. Vérifiez l’environnement cible, par exemple avec typeof String.prototype.replaceAll === "function".
Exemples
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Résultat
a-b-a A.b.A $&.b.$& a.b.a
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.