...
Eroare JavaScript · Șiruri, expresii regulate și URI

RangeError: The normalization form should be one of NFC, NFD, NFKC, NFKD.

Pe scurt

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

Greșit
JavaScript
const fara = text.normalize("nfd").replace(/[\u0300-\u036f]/g, "");
Corect
JavaScript
const fara = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "");

Valorile sunt sensibile la majuscule: doar "NFD" e acceptat.

2Literele inversate

Greșit
JavaScript
text.normalize("NDF");
Corect
JavaScript
text.normalize("NFD");

NFD vine de la Normalization Form Decomposition.

3Forma luată dintr-o setare fără validare

Greșit
JavaScript
text.normalize(setari.forma); // "decompose"
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
function slug(titlu) {
  return titlu
    .normalize("nfd")
    .replace(/[\u0300-\u036f]/g, "")
    .toLowerCase()
    .split(" ")
    .join("-");
}

console.log(slug("Știință și tehnică"));
După reparație, programul afișează
stiinta-si-tehnica
Indiciu

Forma de normalizare se scrie cu majuscule.

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 localeCompare cu { 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

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.