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

CKTIS / JavaScript

String.prototype.normalize — normalizacija Unicode

normalize() vrne besedilo v izbrani obliki normalizacije Unicode. Pomaga primerjati enakovredne zapise znakov ter podpira NFC, NFD, NFKC in NFKD; privzeta oblika je NFC.

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

str.normalize(form = "NFC")

String.prototype.normalize vrne normaliziran niz, ne da bi spremenila vhod. Navidez enako besedilo lahko vsebuje različna zaporedja kodnih točk: "\u00E9" in "e\u0301" predstavljata é, vendar pri === nista enaka. Pred primerjavo normaliziraj obe strani v isto obliko.

"NFD" izvede kanonično razstavitev; "NFC" znake tudi sestavi, kjer to določa Unicode. "NFKD" izvede združljivostno razstavitev, medtem ko "NFKC" doda kanonično sestavljanje. Združljivostne oblike lahko odstranijo pomembne razlike: ligatura "\uFB00" postane "ff". Uporabi jih premišljeno, ne kot univerzalno čiščenje besedila.

Če form izpustiš ali podaš undefined, se izbere "NFC". Sicer metoda poskusi pretvoriti form v niz. Če podaš vrednost tipa Symbol, pretvorba sproži TypeError. Če pretvorba uspe, a dobljeni niz ni natančno enak nobeni od vrednosti "NFC", "NFD", "NFKC" ali "NFKD", metoda sproži RangeError. Velikost črk je pomembna. Prejemnik se pretvori v niz, vendar prejemnik null ali undefined povzroči TypeError.

Normalizacija ni pretvarjanje med velikimi in malimi črkami niti splošno odstranjevanje naglasov. Spremeni lahko length, ki šteje 16-bitne kodne enote UTF-16, ne pa vidnih znakov. To je metoda jezika ECMAScript, ne API DOM; razpoložljivost v ciljnem brskalniku je treba preveriti neodvisno od različice Node, uporabljene v projektu.

Primeri

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

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

Viri