Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.replaceAll — zamjena svih podudaranja

replaceAll zamjenjuje svako nepoklapajuće podudaranje niza ili globalnog regularnog izraza, a da pritom ne mijenja izvorni niz. Zamjena može biti tekst ili funkcija.

Verzija: 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)

Kada je uzorak niz, String.prototype.replaceAll vraća niz u kojem su slijeva nadesno zamijenjena sva nepoklapajuća podudaranja. Ne mijenja izvorni niz i ponovno ne pretražuje umetnuti tekst. Ako nema podudaranja, sadržaj rezultata ostaje nepromijenjen. Za razliku od metode replace s nizom kao uzorkom, ne zaustavlja se nakon prvog podudaranja.

Nizovni searchValue tumači se doslovno: "." znači točku, a ne bilo koji znak. Regularni izraz mora imati zastavicu g; ako je nema, dolazi do pogreške TypeError. Prazan nizovni uzorak podudara se sa svakom granicom UTF-16 kodnih jedinica, uključujući početak i kraj: "ab".replaceAll("", "-") daje "-a-b-". Objekt s metodom [Symbol.replace] može preuzeti operaciju i odrediti njezin rezultat.

replaceValue može biti tekst ili funkcija. U tekstu zamjene $$ označava znak dolara, a $& podudaranje; regularni izrazi podržavaju i reference na grupe za hvatanje. Za doslovno umetanje dinamičkog teksta koji sadrži te nizove upotrijebite () => replacement. Za nizovni uzorak funkcija prima (match, offset, string); za regularni izraz prima i grupe za hvatanje prije pomaka te, ako postoje imenovane grupe, objekt imenovanih grupa na kraju.

Metoda je dio ECMAScripta 2021, a ne Web APIs. Specifikacija nije tablica kompatibilnosti preglednika; činjenica da je Node 24 prisutan u repozitoriju ne dokazuje podršku u pregledniku. Provjerite ciljano okruženje, primjerice pomoću typeof String.prototype.replaceAll === "function".

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori