CKTIS / JavaScript
String.prototype.normalize — Unicode-normalisatie
normalize() geeft tekst terug in een gekozen Unicode-normalisatievorm. De methode helpt equivalente tekenrepresentaties te vergelijken en ondersteunt NFC, NFD, NFKC en NFKD; NFC is de standaardvorm.
Versie: 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 geeft een genormaliseerde tekenreeks terug zonder de invoer te wijzigen. Tekst die er hetzelfde uitziet, kan verschillende codepuntreeksen bevatten: "\u00E9" en "e\u0301" stellen é voor, maar zijn niet gelijk met ===. Normaliseer beide kanten naar dezelfde vorm voordat je ze vergelijkt.
"NFD" voert canonieke decompositie uit; "NFC" combineert tekens ook waar Unicode dat voorschrijft. "NFKD" voert compatibiliteitsdecompositie uit, terwijl "NFKC" daar canonieke compositie aan toevoegt. Compatibiliteitsvormen kunnen betekenisvolle verschillen wegnemen: de ligatuur "\uFB00" wordt "ff". Kies ze bewust; ze zijn geen universele manier om tekst op te schonen.
Als form wordt weggelaten of undefined wordt doorgegeven, wordt "NFC" gekozen. Anders probeert de methode form om te zetten naar een tekenreeks. Als je een Symbol doorgeeft, veroorzaakt die omzetting een TypeError. Slaagt de omzetting, maar is de resulterende tekenreeks niet exact "NFC", "NFD", "NFKC" of "NFKD", dan geeft de methode een RangeError. Hoofdletters en kleine letters zijn van belang. De ontvanger wordt omgezet naar een tekenreeks, maar een ontvanger van null of undefined veroorzaakt een TypeError.
Normalisatie is geen omzetting van hoofdletters naar kleine letters (of andersom) en ook geen algemene verwijdering van accenten. De methode kan length veranderen, dat UTF-16-code-eenheden telt in plaats van zichtbare tekens. Dit is een ECMAScript-taalmethode, geen DOM-API; controleer de beschikbaarheid in de doelbrowser onafhankelijk van de Node-versie die het project gebruikt.
Voorbeelden
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");Resultaat
false true 1 2 2 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.