База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници