Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła