CKTIS / JavaScript
String.prototype.normalize — нормализация на Unicode
normalize() връща текст в избрана форма за нормализация на Unicode. Помага при сравняване на еквивалентни представяния на знаци и поддържа NFC, NFD, NFKC и NFKD; по подразбиране се използва NFC.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
str.normalize(form = "NFC")String.prototype.normalize връща нормализиран низ, без да променя входа. Текстове, които изглеждат еднакво, може да съдържат различни последователности от кодови точки: "\u00E9" и "e\u0301" представят é, но не са равни при ===. Преди сравнение нормализирай и двете страни до една и съща форма.
"NFD" извършва канонично разлагане; "NFC" също съставя знаци там, където Unicode го предвижда. "NFKD" извършва разлагане по съвместимост, а "NFKC" добавя канонично съставяне. Формите за съвместимост може да премахнат значими различия: лигатурата "\uFB00" става "ff". Използвай ги внимателно, а не като универсално почистване на текст.
Ако form бъде пропуснат или се подаде undefined, се избира "NFC". В противен случай методът се опитва да преобразува form в низ. Ако се подаде стойност от тип Symbol, при преобразуването се хвърля TypeError. Ако преобразуването е успешно, но полученият низ не съвпада точно с нито една от стойностите "NFC", "NFD", "NFKC" или "NFKD", методът хвърля RangeError. Значение има регистърът. Получателят се преобразува в низ, но получател null или undefined причинява TypeError.
Нормализацията не е преобразуване на главни и малки букви, нито общо премахване на ударения. Тя може да промени length, който брои 16-битови кодови единици UTF-16, а не видими знаци. Това е метод на езика ECMAScript, а не DOM API; наличността му в целевия браузър трябва да се провери независимо от версията на Node, използвана в проекта.
Примери
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");Резултат
false true 1 2 2 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.