CKTIS / JavaScript
String.prototype.replace — zastępowanie tekstu
replace() zwraca tekst po zastąpieniu dopasowania, nie zmieniając oryginału. Poznaj różnicę między wyszukiwaniem tekstowym a wyrażeniem regularnym oraz między szablonem zastąpienia a funkcją.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
text.replace(searchValue, replaceValue)String.prototype.replace dla zwykłego tekstu lub standardowego RegExp zwraca nowy tekst; oryginał pozostaje niezmieniony. Brak dopasowania oznacza zwrócenie niezmienionej treści. To API języka ECMAScript, a nie API przeglądarki.
Tekstowy searchValue jest dosłowny i zastępuje tylko pierwsze wystąpienie; pusty tekst pasuje na początku. Standardowy RegExp bez g zastępuje najwyżej jedno dopasowanie, a z g — wszystkie znalezione dopasowania. Obiekt z metodą [Symbol.replace] może zdefiniować własne zachowanie, w tym wynik.
Tekstowy replaceValue interpretuje $$ jako $, $& jako całe dopasowanie, a $1 jako pierwszą istniejącą grupę przechwytującą. Funkcja zastępująca otrzymuje dopasowanie, następnie przechwycone grupy, indeks i tekst wejściowy; przy nazwanych grupach otrzymuje dodatkowo obiekt groups. Indeks jest liczony w jednostkach kodowych UTF-16. Wynik funkcji jest konwertowany na tekst, ale sekwencje $ nie są interpretowane.
Przykład porównuje pierwsze zastąpienie, zastąpienie globalne, użycie grupy i dosłowny wynik funkcji. Wypisz także text, aby sprawdzić niezmienność oryginału.
Przykłady
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);Wynik
dog cat dog dog [cat] [cat] $& $& cat cat
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.