Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje