CKTIS / JavaScript
String.prototype.replaceAll — zastępowanie wszystkich dopasowań
Metoda replaceAll zastępuje wszystkie nienakładające się dopasowania tekstu lub globalnego wyrażenia regularnego, nie zmieniając oryginalnego ciągu. Zamiennikiem może być tekst albo funkcja.
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.replaceAll(searchValue, replaceValue)String.prototype.replaceAll dla tekstowego wzorca zwraca ciąg ze wszystkimi nienakładającymi się dopasowaniami zastąpionymi od lewej do prawej. Nie zmienia oryginału i nie przeszukuje ponownie wstawionego tekstu. Brak dopasowań oznacza niezmienioną treść wyniku. W odróżnieniu od replace z tekstowym wzorcem nie kończy po pierwszym dopasowaniu.
Tekstowy searchValue jest dosłowny: "." oznacza kropkę, nie dowolny znak. Wyrażenie regularne musi mieć flagę g; jej brak powoduje TypeError. Pusty wzorzec tekstowy dopasowuje każdą granicę jednostek UTF-16, również początek i koniec: "ab".replaceAll("", "-") daje "-a-b-". Obiekt z metodą [Symbol.replace] może przejąć operację i określić jej wynik.
replaceValue może być tekstem lub funkcją. W tekście zamiennika $$ oznacza znak dolara, a $& — dopasowanie; przy wyrażeniu regularnym dostępne są też odwołania do grup przechwytujących. Aby wstawić dosłownie dynamiczny tekst zawierający takie sekwencje, użyj () => replacement. Dla tekstowego wzorca funkcja otrzymuje (match, offset, string); dla wyrażenia regularnego dodatkowo otrzymuje grupy przechwytujące przed przesunięciem oraz obiekt nazwanych grup na końcu, jeśli takie grupy istnieją.
Metoda należy do ECMAScript 2021, a nie do Web APIs. Specyfikacja nie jest tabelą zgodności przeglądarek; obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce. Sprawdź środowisko docelowe, np. przez typeof String.prototype.replaceAll === "function".
Przykłady
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Wynik
a-b-a A.b.A $&.b.$& a.b.a
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.