Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

String.prototype.replaceAll — zamenjava vseh ujemanj

replaceAll zamenja vsako neprekrivajoče se ujemanje niza ali globalnega regularnega izraza, ne da bi spremenila izvirni niz. Nadomestilo je lahko besedilo ali funkcija.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

text.replaceAll(searchValue, replaceValue)

Če je vzorec niz, String.prototype.replaceAll vrne niz, v katerem od leve proti desni zamenja vsako neprekrivajoče se ujemanje. Izvirnega niza ne spremeni in vstavljenega besedila ne išče znova. Če ni ujemanj, vsebina rezultata ostane nespremenjena. V nasprotju z replace z vzorcem v obliki niza se ne ustavi po prvem ujemanju.

Nizovni searchValue se obravnava dobesedno: "." pomeni piko, ne poljubnega znaka. Regularni izraz mora imeti zastavico g; če je nima, se sproži TypeError. Prazen nizovni vzorec se ujema z vsako mejo enot kode UTF-16, tudi na začetku in koncu: "ab".replaceAll("", "-") ustvari "-a-b-". Objekt z metodo [Symbol.replace] lahko prevzame operacijo in določi njen rezultat.

replaceValue je lahko besedilo ali funkcija. V nadomestnem besedilu $$ pomeni znak za dolar, $& pa ujemanje; regularni izrazi podpirajo tudi sklice na zajemne skupine. Če želiš dobesedno vstaviti dinamično besedilo, ki vsebuje te nize, uporabi () => replacement. Pri nizovnem vzorcu funkcija prejme (match, offset, string); pri regularnem izrazu prejme še zajemne skupine pred odmikom in, če obstajajo poimenovane skupine, na koncu objekt poimenovanih skupin.

Metoda je del ECMAScript 2021, ne Web APIs. Specifikacija ni tabela združljivosti brskalnikov; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku. Preveri ciljno okolje, na primer z typeof String.prototype.replaceAll === "function".

Primeri

const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);

Rezultat

a-b-a
A.b.A
$&.b.$&
a.b.a

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri