CKTIS / JavaScript
String.prototype.normalize — Unicode-Normalisierung
normalize() gibt Text in einer ausgewählten Unicode-Normalisierungsform zurück. Das erleichtert den Vergleich gleichwertiger Zeichendarstellungen. Unterstützt werden NFC, NFD, NFKC und NFKD; standardmäßig wird NFC verwendet.
Version: 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 gibt eine normalisierte Zeichenkette zurück, ohne die Eingabe zu verändern. Optisch identischer Text kann unterschiedliche Codepunktfolgen enthalten: "\u00E9" und "e\u0301" stellen é dar, sind mit === aber nicht gleich. Normalisiere vor dem Vergleich beide Seiten in dieselbe Form.
"NFD" führt eine kanonische Zerlegung durch; "NFC" fügt Zeichen zusätzlich dort zusammen, wo Unicode dies vorsieht. "NFKD" führt eine Kompatibilitätszerlegung durch, während "NFKC" die kanonische Zusammensetzung ergänzt. Kompatibilitätsformen können bedeutsame Unterschiede beseitigen: Die Ligatur "\uFB00" wird zu "ff". Verwende sie bewusst und nicht als universelle Textbereinigung.
Wird form weggelassen oder undefined übergeben, wird "NFC" gewählt. Andernfalls versucht die Methode, form in eine Zeichenkette umzuwandeln. Wird ein Symbol übergeben, löst diese Umwandlung einen TypeError aus. Gelingt die Umwandlung, entspricht die resultierende Zeichenkette aber keiner der vier Zeichenketten "NFC", "NFD", "NFKC" oder "NFKD" exakt, löst die Methode einen RangeError aus. Groß- und Kleinschreibung ist relevant. Der Empfänger wird in eine Zeichenkette umgewandelt; bei null oder undefined als Empfänger tritt jedoch ein TypeError auf.
Normalisierung ist weder eine Umwandlung der Groß-/Kleinschreibung noch eine allgemeine Entfernung von Akzenten. Sie kann length ändern, das UTF-16-Codeeinheiten und nicht sichtbare Zeichen zählt. Dies ist eine ECMAScript-Sprachmethode, keine DOM-API; die Verfügbarkeit im Zielbrowser muss unabhängig von der im Projekt verwendeten Node-Version geprüft werden.
Beispiele
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");Ergebnis
false true 1 2 2 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.