Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.normalize — normalizacija Unicodea

normalize() vraća tekst u odabranom obliku normalizacije Unicodea. Pomaže u uspoređivanju ekvivalentnih zapisa znakova te podržava NFC, NFD, NFKC i NFKD; zadani je oblik NFC.

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

str.normalize(form = "NFC")

String.prototype.normalize vraća normalizirani niz znakova bez promjene ulaza. Tekstovi koji izgledaju jednako mogu sadržavati različite nizove kodnih točaka: "\u00E9" i "e\u0301" predstavljaju é, ali nisu jednaki pri uporabi ===. Prije usporedbe normaliziraj obje strane u isti oblik.

"NFD" provodi kanonsku dekompoziciju; "NFC" dodatno spaja znakove ondje gdje to Unicode propisuje. "NFKD" provodi kompatibilnu dekompoziciju, dok "NFKC" dodaje kanonsko spajanje. Kompatibilni oblici mogu ukloniti važne razlike: ligatura "\uFB00" postaje "ff". Odaberi ih promišljeno, a ne kao univerzalno čišćenje teksta.

Ako izostaviš form ili proslijediš undefined, odabire se "NFC". U suprotnom metoda pokušava pretvoriti form u niz znakova. Ako proslijediš vrijednost tipa Symbol, pretvorba uzrokuje TypeError. Ako pretvorba uspije, ali dobiveni niz nije točno jednak nijednoj od vrijednosti "NFC", "NFD", "NFKC" ili "NFKD", metoda izbacuje RangeError. Velika i mala slova su važna. Primatelj se pretvara u niz znakova, ali primatelj null ili undefined uzrokuje TypeError.

Normalizacija nije pretvaranje velikih i malih slova ni općenito uklanjanje naglasaka. Može promijeniti length, koji broji 16-bitne jedinice UTF-16, a ne vidljive znakove. To je metoda jezika ECMAScript, a ne DOM API; dostupnost u ciljnom pregledniku treba provjeriti neovisno o verziji Nodea koju projekt koristi.

Primjeri

const composed = "\u00E9";
const decomposed = "e\u0301";
console.log(composed === decomposed);
console.log(composed.normalize() === decomposed.normalize());
console.log(composed.length, decomposed.length);
console.log(composed.normalize("NFD").length);
console.log("\uFB00".normalize("NFKC") === "ff");

Rezultat

false
true
1 2
2
true

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

Izvori