RangeError: The normalization form should be one of NFC, NFD, NFKC, NFKD.
Ai apelat text.normalize(...) cu o formă necunoscută, de obicei scrisă cu litere mici ("nfd") sau greșit ("NDF"). Valorile acceptate sunt exact "NFC", "NFD", "NFKC", "NFKD", cu majuscule. Pentru eliminarea diacriticelor se folosește normalize("NFD").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
String.prototype.normalize(forma) aduce un text la o formă Unicode standard. Acceptă doar patru valori, cu litere mari: "NFC" (implicit, caractere compuse), "NFD" (caractere descompuse: litera de bază plus semnul diacritic separat), "NFKC" și "NFKD" (în plus, unifică variante de compatibilitate, de exemplu ligaturi). Orice altă valoare aruncă această RangeError.
Cel mai des apare în codul care elimină diacriticele pentru slug-uri, căutare sau comparații: text.normalize("NFD").replace(/[\u0300-\u036f]/g, ""). NFD desface ș în s + virgula de dedesubt, iar regex-ul șterge semnele diacritice. Dacă scrii "nfd", "NFD " (cu spațiu) sau "NDF", primești eroarea.
Fără argument, normalize() folosește NFC, care nu desparte diacriticele, deci nu dă eroare, dar nici nu ajută la eliminarea lor.
De ce apare: cauzele frecvente
1Forma scrisă cu litere mici
const fara = text.normalize("nfd").replace(/[\u0300-\u036f]/g, "");const fara = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "");Valorile sunt sensibile la majuscule: doar "NFD" e acceptat.
2Literele inversate
text.normalize("NDF");text.normalize("NFD");NFD vine de la Normalization Form Decomposition.
3Forma luată dintr-o setare fără validare
text.normalize(setari.forma); // "decompose"const FORME = ["NFC", "NFD", "NFKC", "NFKD"];
const forma = FORME.includes(setari.forma) ? setari.forma : "NFC";
text.normalize(forma);Verifici valoarea și folosești forma implicită când nu e validă.
Repară eroarea, direct în pagină
Funcția slug transformă titlul unui articol într-o adresă fără diacritice, dar programul se oprește cu RangeError: The normalization form should be one of NFC, NFD, NFKC, NFKD. Repară apelul lui normalize ca programul să afișeze stiinta-si-tehnica.
function slug(titlu) {
return titlu
.normalize("nfd")
.replace(/[\u0300-\u036f]/g, "")
.toLowerCase()
.split(" ")
.join("-");
}
console.log(slug("Știință și tehnică"));stiinta-si-tehnica
Indiciu
Forma de normalizare se scrie cu majuscule.
Reparația
function slug(titlu) {
return titlu
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "")
.toLowerCase()
.split(" ")
.join("-");
}
console.log(slug("Știință și tehnică"));De ce merge
normalize acceptă doar cele patru forme standard, scrise exact cu majuscule, așa că "nfd" a fost respins cu RangeError. Cu "NFD", fiecare literă cu diacritice se desface în litera de bază plus semnul separat (de exemplu ș devine s + virgula de dedesubt). Regex-ul șterge semnele din intervalul \u0300-\u036f, apoi textul trece în litere mici, iar spațiile devin cratime.
Alte forme ale mesajului
RangeError: form must be one of 'NFC', 'NFD', 'NFKC', or 'NFKD'
Cum o eviți pe viitor
- Definește o funcție
faraDiacritice(text)o singură dată și refolosește-o. - Scrie formele mereu cu majuscule, ca în standard:
"NFC","NFD". - Pentru comparații fără diacritice, ia în calcul și
localeComparecu{ sensitivity: "base" }. - Normalizează textul (NFC) când îl salvezi, ca aceleași cuvinte să fie stocate la fel.
Întrebări frecvente
De ce două texte care arată la fel nu sunt egale?
Un ă poate fi stocat ca un singur caracter sau ca a plus semnul diacritic separat. Arată identic, dar === dă false. a.normalize() === b.normalize() rezolvă comparația.
Funcționează și pentru ș și ț românești?
Da: NFD le desface în s/t plus virgula de dedesubt (U+0326), care e în intervalul \u0300-\u036f, deci regex-ul o elimină.
Erori înrudite
URIError: URI malformed `decodeURIComponent` sau `decodeURI` a primit un text cu un `%` care nu e urmat de două cifre hexazecimale valide (de exemplu „50%” sau „%E2%82”). Decodează doar texte codate corect, codează cu `encodeURIComponent` și pune decodarea într-un `try...catch` când textul vine din exterior. RangeError: Incorrect locale information provided Ai dat lui `toLocaleString`, `toLocaleDateString` sau `Intl.*` un cod de limbă scris greșit, de exemplu `"ro_RO"` (cu underscore) sau `"romana"`. Codurile valide au forma BCP 47 cu cratimă: `"ro-RO"`, `"ro"`, `"en-US"`. TypeError: String.prototype.replaceAll called with a non-global RegExp argument Ai dat lui `replaceAll` o expresie regulată fără flagul `g`. `replaceAll` cu regex cere obligatoriu `g`. Adaugă `g` (`/-/g`), folosește `replace` cu `/.../g` sau dă un text simplu: `text.replaceAll("-", "/")`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
