WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen