Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.replaceAll — sostituire tutte le corrispondenze

replaceAll sostituisce ogni corrispondenza non sovrapposta di una stringa o di un’espressione regolare globale senza modificare la stringa originale. Il testo sostitutivo può essere una stringa o una funzione.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

text.replaceAll(searchValue, replaceValue)

Con un pattern stringa, String.prototype.replaceAll restituisce una stringa in cui ogni corrispondenza non sovrapposta viene sostituita da sinistra a destra. Non modifica la stringa originale e non cerca di nuovo nel testo inserito. Se non ci sono corrispondenze, il contenuto del risultato rimane invariato. A differenza di replace con un pattern stringa, non si ferma dopo la prima corrispondenza.

Un searchValue stringa viene interpretato letteralmente: "." indica un punto, non un carattere qualsiasi. Un’espressione regolare deve avere il flag g; se manca, viene generato un TypeError. Un pattern stringa vuoto corrisponde a ogni confine tra unità di codice UTF-16, compresi l’inizio e la fine: "ab".replaceAll("", "-") produce "-a-b-". Un oggetto con un metodo [Symbol.replace] può prendere il controllo dell’operazione e determinarne il risultato.

replaceValue può essere testo o una funzione. Nel testo sostitutivo, $$ indica un simbolo del dollaro e $& la corrispondenza; con le espressioni regolari sono supportati anche i riferimenti ai gruppi di cattura. Per inserire letteralmente testo dinamico che contiene queste sequenze, usa () => replacement. Con un pattern stringa, la funzione riceve (match, offset, string); con un’espressione regolare riceve anche i gruppi di cattura prima dell’offset e, se esistono gruppi con nome, un oggetto dei gruppi con nome alla fine.

Il metodo fa parte di ECMAScript 2021, non delle Web APIs. La specifica non è una tabella di compatibilità dei browser; la presenza di Node 24 in un repository non dimostra il supporto nei browser. Controlla l’ambiente di destinazione, per esempio con typeof String.prototype.replaceAll === "function".

Esempi

const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);

Risultato

a-b-a
A.b.A
$&.b.$&
a.b.a

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti