CKTIS / JavaScript
String.prototype.normalize — normalizácia Unicode
normalize() vracia text vo zvolenej normalizačnej forme Unicode. Pomáha porovnávať ekvivalentné zápisy znakov a podporuje NFC, NFD, NFKC a NFKD; predvolená je NFC.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
str.normalize(form = "NFC")String.prototype.normalize vracia normalizovaný reťazec bez zmeny vstupu. Texty, ktoré vyzerajú rovnako, môžu obsahovať rôzne sekvencie kódových bodov: "\u00E9" a "e\u0301" predstavujú é, ale pri použití === nie sú rovnaké. Pred porovnaním normalizuj obe strany do rovnakej formy.
"NFD" vykonáva kanonickú dekompozíciu; "NFC" navyše skladá znaky tam, kde to určuje Unicode. "NFKD" vykonáva kompatibilitnú dekompozíciu, zatiaľ čo "NFKC" pridáva kanonické skladanie. Kompatibilitné formy môžu odstrániť významné rozdiely: ligatúra "\uFB00" sa zmení na "ff". Vyberaj ich uvážene, nie ako univerzálne čistenie textu.
Ak form vynecháš alebo odovzdáš undefined, použije sa "NFC". Inak sa metóda pokúsi previesť form na reťazec. Ak odovzdáš hodnotu typu Symbol, prevod vyvolá TypeError. Ak sa prevod podarí, ale výsledný reťazec presne nezodpovedá žiadnej z hodnôt "NFC", "NFD", "NFKC" alebo "NFKD", metóda vyvolá RangeError. Na veľkosti písmen záleží. Prijímač sa prevedie na reťazec, ale prijímač null alebo undefined spôsobí TypeError.
Normalizácia nie je zmena veľkosti písmen ani všeobecné odstraňovanie diakritiky. Môže zmeniť length, ktorý počíta 16-bitové jednotky UTF-16, nie viditeľné znaky. Ide o metódu jazyka ECMAScript, nie o DOM API; dostupnosť v cieľovom prehliadači treba overiť nezávisle od verzie Node používanej v projekte.
Príklady
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");Výsledok
false true 1 2 2 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.