CKTIS / JavaScript
String.prototype.replace — sostituire il testo
replace() restituisce un testo con le corrispondenze sostituite, senza modificare l’originale. Scopri la differenza tra la ricerca con stringhe e con espressioni regolari, e tra i modelli di sostituzione e le funzioni di sostituzione.
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.replace(searchValue, replaceValue)String.prototype.replace restituisce una nuova stringa con una stringa semplice o un RegExp standard; l’originale rimane invariato. Se non ci sono corrispondenze, viene restituito il contenuto senza modifiche. È un’API del linguaggio ECMAScript, non un’API del browser.
Un searchValue di tipo stringa viene trattato letteralmente e sostituisce solo la prima occorrenza; una stringa vuota corrisponde all’inizio. Un RegExp standard senza g sostituisce al massimo una corrispondenza; con g, sostituisce tutte le corrispondenze trovate. Un oggetto con un metodo [Symbol.replace] può definire un comportamento personalizzato, incluso il risultato.
Un replaceValue di tipo stringa interpreta $$ come $, $& come l’intera corrispondenza e $1 come il primo gruppo di cattura esistente. Una funzione di sostituzione riceve la corrispondenza, poi i gruppi catturati, l’indice e la stringa di input; se ci sono gruppi con nome, viene aggiunto come ultimo argomento un oggetto groups. L’indice conta le unità di codice UTF-16. Il risultato della funzione viene convertito in stringa, ma le sequenze $ non vengono interpretate.
L’esempio confronta la sostituzione della prima corrispondenza, quella globale, un riferimento a un gruppo di cattura e il risultato letterale di una funzione. Stampare text permette anche di verificare che l’originale resti invariato.
Esempi
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);Risultato
dog cat dog dog [cat] [cat] $& $& cat cat
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.