Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.replace — remplacer du texte

replace() renvoie un texte dans lequel les correspondances sont remplacées, sans modifier l’original. Découvrez la différence entre une recherche par chaîne et par expression régulière, ainsi qu’entre les modèles de remplacement et les fonctions de remplacement.

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.replace(searchValue, replaceValue)

String.prototype.replace renvoie une nouvelle chaîne avec une chaîne simple ou un RegExp standard ; l’original reste inchangé. En l’absence de correspondance, le contenu est renvoyé sans modification. Il s’agit d’une API du langage ECMAScript, et non d’une API de navigateur.

Un searchValue de type chaîne est littéral et ne remplace que la première occurrence ; une chaîne vide correspond au début. Un RegExp standard sans g remplace au plus une correspondance ; avec g, il remplace toutes les correspondances trouvées. Un objet doté d’une méthode [Symbol.replace] peut définir un comportement personnalisé, y compris le résultat.

Un replaceValue de type chaîne interprète $$ comme $, $& comme la correspondance entière et $1 comme le premier groupe capturé existant. Une fonction de remplacement reçoit la correspondance, puis les groupes capturés, l’index et la chaîne d’entrée ; en présence de groupes nommés, un objet groups est ajouté en dernier argument. L’index compte les unités de code UTF-16. Le résultat de la fonction est converti en chaîne, mais les séquences $ ne sont pas interprétées.

L’exemple compare le remplacement de la première occurrence seulement, le remplacement global, une référence à un groupe capturé et le résultat littéral d’une fonction. L’affichage de text permet aussi de vérifier que l’original reste inchangé.

Exemples

const text = "cat cat";
console.log(text.replace("cat", "dog"));
console.log(text.replace(/cat/g, "dog"));
console.log(text.replace(/(cat)/g, "[$1]"));
console.log(text.replace(/cat/g, () => "$&"));
console.log(text);

Résultat

dog cat
dog dog
[cat] [cat]
$& $&
cat cat

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.

Sources