CKTIS / JavaScript
String.prototype.normalize — normalizace Unicode
normalize() vrací text ve zvolené normalizační podobě Unicode. Pomáhá porovnávat ekvivalentní zápisy znaků a podporuje NFC, NFD, NFKC a NFKD; výchozí je NFC.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.normalize(form = "NFC")String.prototype.normalize vrací normalizovaný řetězec, aniž by měnila vstup. Texty, které vypadají stejně, mohou obsahovat různé sekvence kódových bodů: "\u00E9" a "e\u0301" představují é, ale při použití === se nerovnají. Před porovnáním normalizuj obě strany do stejné podoby.
"NFD" provádí kanonickou dekompozici; "NFC" navíc skládá znaky tam, kde to Unicode stanovuje. "NFKD" provádí kompatibilitní dekompozici, zatímco "NFKC" přidává kanonické skládání. Kompatibilitní podoby mohou odstranit významné rozdíly: ligatura "\uFB00" se změní na "ff". Používej je uvážlivě, nikoli jako univerzální čištění textu.
Pokud form vynecháš nebo předáš undefined, zvolí se "NFC". Jinak se metoda pokusí převést form na řetězec. Pokud předáš hodnotu typu Symbol, převod vyvolá TypeError. Pokud se převod podaří, ale výsledný řetězec přesně neodpovídá žádné z hodnot "NFC", "NFD", "NFKC" nebo "NFKD", metoda vyvolá RangeError. Na velikosti písmen záleží. Příjemce se převede na řetězec, ale příjemce null nebo undefined způsobí TypeError.
Normalizace není změna velikosti písmen ani obecné odstraňování diakritiky. Může změnit length, který počítá 16bitové jednotky UTF-16, nikoli viditelné znaky. Jde o metodu jazyka ECMAScript, nikoli o DOM API; dostupnost v cílovém prohlížeči je nutné ověřit nezávisle na verzi Node použité v projektu.
Pří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ýsledek
false true 1 2 2 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.