Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.normalize — normalizacja Unicode

normalize() zwraca tekst w wybranej postaci normalizacji Unicode. Pomaga porównywać równoważne zapisy znaków; obsługuje NFC, NFD, NFKC i NFKD, domyślnie NFC.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

str.normalize(form = "NFC")

String.prototype.normalize zwraca znormalizowany ciąg znaków, nie zmieniając wejścia. Pozornie identyczne teksty mogą mieć różne sekwencje punktów kodowych: "\u00E9" i "e\u0301" przedstawiają é, ale nie są równe przy ===. Przed porównaniem normalizuj obie strony do tej samej postaci.

"NFD" wykonuje dekompozycję kanoniczną; "NFC" dodatkowo składa znaki tam, gdzie przewiduje to Unicode. "NFKD" wykonuje dekompozycję zgodnościową, a "NFKC" dodaje składanie kanoniczne. Postacie zgodnościowe mogą usuwać istotne rozróżnienia: ligatura "\uFB00" staje się "ff". Wybieraj je świadomie, nie jako uniwersalne czyszczenie tekstu.

Pominięcie form lub przekazanie undefined oznacza "NFC". W pozostałych przypadkach metoda próbuje przekonwertować form na tekst. Przekazanie wartości typu Symbol powoduje TypeError podczas tej konwersji. Jeśli konwersja się powiedzie, ale wynik nie jest dokładnie jedną z wartości "NFC", "NFD", "NFKC" lub "NFKD", metoda rzuca RangeError. Wielkość liter ma znaczenie. Odbiorca jest konwertowany na tekst, ale null i undefined jako odbiorcy powodują TypeError.

Normalizacja nie jest zamianą wielkości liter ani ogólnym usuwaniem akcentów. Może zmienić length, które liczy jednostki kodowe UTF-16, a nie widoczne znaki. To metoda języka ECMAScript, nie API DOM; jej dostępność w docelowej przeglądarce trzeba sprawdzić niezależnie od wersji Node używanej w projekcie.

Przykłady

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");

Wynik

false
true
1 2
2
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła