Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti