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.