| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/replaceAll | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis aot 2020.
La mthode replaceAll() retourne une nouvelle chane de caractres dans laquelle toutes les occurrences d'un motif donn ont t remplaces par une chane de remplacement. L'argument pattern fournit pour dcrire le motif peut tre une chane de caractres ou une expression rationnelle (RegExp), l'argument replacement peut tre une chane de caractres ou une fonction qui sera appele pour chaque correspondance.
La chane de caractres initiale restera inchange.
const paragraph = "I think Ruth's dog is cuter than your dog!";
console.log(paragraph.replaceAll("dog", "monkey"));
// Expected output: "I think Ruth's monkey is cuter than your monkey!"
// Global flag required when calling replaceAll with regex
const regex = /Dog/gi;
console.log(paragraph.replaceAll(regex, "ferret"));
// Expected output: "I think Ruth's ferret is cuter than your ferret!"
const newStr = str.replaceAll(regexp|substr, newSubstr|function)
Note :
Quand on utilise une expression rationnelle, il est ncessaire d'utiliser le marqueur global ("g"); autrement, l'exception TypeError: "replaceAll must be called with a global RegExp" sera leve.
regexp (le motif rechercher)Un objet ou littrale RegExp avec le marqueur global. Les correspondances sont remplaces par newSubstr ou la valeur retourne par la function spcifie. Une RegExp sans le marqueur global ("g") renverra l'erreur TypeError: "replaceAll must be called with a global RegExp".
substrUne chane de caractres (String) qui sera remplace par newSubstr. Elle est traite comme une chane de caracres littrale et non pas comme une expression rgulire.
newSubstr (remplacement)La chane de caractres (String) qui remplacera la sous-chane indique par la regexp ou substr donne en paramtre. Un certain nombre de motifs spciaux pour le remplacement sont pris en charge, voir la section "Spcifier une chane de caractres comme paramtre" ci-dessous.
function (remplacement)Une fonction qui a pour but de crer la nouvelle sous-chane qui remplacera les occurrences trouves via la regexp ou substr donne en paramtre. Les arguments passs cette fonction sont dtaills dans la section "Spcifier une fonction comme paramtre" ci-dessous.
Une nouvelle chane avec toutes les occurrences trouves remplaces par le pattern de remplacement.
Cette mthode ne remplace ni ne modifie l'objet String original. Elle retourne juste une nouvelle chane de caractres.
La chane de caractres de remplacement peut inclure les motifs de remplacement spciaux suivants :
| Motif | Insertion |
|---|---|
$$ |
Insre un "$". |
$& |
Insre la chane de caractres trouve. |
$` |
Insre la portion de chane de caractres qui prcde celle trouve. |
$' |
Insre la portion de chane de caractres qui suit celle trouve. |
$n |
O n est un entier positif infrieur 100. Insre la n-ime occurrence trouve, condition que le premier argument soit un objet RegExp. Cet indice dmarre partir de 1. |
Vous pouvez passer une fonction comme second paramtre. Dans ce cas, la fonction sera appele aprs qu'une occurrence soit trouve. Le rsultat de la fonction (valeur de retour) sera utilis comme chane de remplacement. (Note : les remplacements spciaux mentionns plus haut ne s'appliqueront pas dans ce cas.)
noter que la fonction sera utilise chaque fois qu'une occurrence sera rencontre, si l'expression rgulire donne en paramtre est globale.
La fonction admet les arguments suivants :
| Nom possible | Valeur fournie |
|---|---|
match |
L'occurrence trouve. (Correspond au $& du prcdent
tableau.)
|
p1, p2 |
Le n-ime chane de caractres trouve par une sous-correspondance
entre parenthses, condition que le premier paramtre soit un objet
de type
|
offset |
Le dcalage de la sous-chane trouve dans la chane d'entre (par
exemple, si la chane complte d'entre tait 'abcd' et la
sous-chane 'bc' alors, cet argument vaudra 1.)
|
string |
La chane compte examine. |
Le nombre d'arguments exact dpend du premier argument de replaceAll() : si c'est un objet de type RegExp et, si tel est le cas, du nombre de sous-correspondances entre parenthses qu'il spcifie.
"aabbcc".replaceAll("b", ".");
// 'aa..cc'
Quand on utilise une expression rationnelle pour chercher une valeur, celle-ci doit tre globale. Le code suivant ne fonctionnera pas :
'aabbcc'.replaceAll(/b/, '.');
TypeError: replaceAll must be called with a global RegExp
L'exemple suivant, utilisant le marqueur g, fonctionnera :
"aabbcc".replaceAll(/b/g, ".");
("aa..cc");
| Spcification |
|---|
| ECMAScript 2027 LanguageSpecification # sec-string.prototype.replaceall |
Cette page a t modifie le 17 fvr. 2025 par les contributeurices du MDN.
StringString.prototype.anchor()String.prototype.at()String.prototype.big()String.prototype.blink()String.prototype.bold()String.prototype.charAt()String.prototype.charCodeAt()String.prototype.codePointAt()String.prototype.concat()String.prototype.endsWith()String.prototype.fixed()String.prototype.fontcolor()String.prototype.fontsize()String.prototype.includes()String.prototype.indexOf()isWellFormed()String.prototype.italics()String.prototype.lastIndexOf()String.prototype.link()String.prototype.localeCompare()String.prototype.match()String.prototype.matchAll()String.prototype.normalize()String.prototype.padEnd()String.prototype.padStart()String.prototype.repeat()String.prototype.replace()String.prototype.replaceAll()String.prototype.search()String.prototype.slice()String.prototype.small()String.prototype.split()String.prototype.startsWith()String.prototype.strike()String.prototype.sub()String.prototype.substr()String.prototype.substring()String.prototype.sup()String.prototype.toLocaleLowerCase()String.prototype.toLocaleUpperCase()String.prototype.toLowerCase()String.prototype.toString()String.prototype.toUpperCase()toWellFormed()String.prototype.trim()String.prototype.trimEnd()String.prototype.trimStart()String.prototype.valueOf()String.prototype[@@iterator]()Object/FunctionObject.prototype.__defineGetter__()Object.prototype.__defineSetter__()Object.prototype.__lookupGetter__()Object.prototype.__lookupSetter__()Object.prototype.hasOwnProperty()Object.prototype.isPrototypeOf()Object.prototype.propertyIsEnumerable()Object.prototype.toLocaleString()Object.prototype.toString()Object.prototype.valueOf()Certaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |