TypeError: First argument to Intl.Locale constructor can't be empty or missing
Ai creat new Intl.Locale() fără cod de limbă sau cu undefined, de obicei dintr-o setare a utilizatorului care lipsește. Dă un cod valid, cu o valoare de rezervă: new Intl.Locale(setari.limba ?? "ro-RO").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Intl.Locale reprezintă o limbă și o regiune ("ro-RO", "en-GB") și îți dă bucățile ei: language, region, calendarul, sistemul orar. Spre deosebire de Intl.NumberFormat sau Intl.DateTimeFormat, care pot primi undefined și folosesc atunci limba implicită, constructorul Intl.Locale cere un cod: fără el aruncă First argument to Intl.Locale constructor can't be empty or missing.
Valoarea lipsă vine de obicei din:
- o setare a utilizatorului încă necompletată (
profil.limba); - un câmp lipsă din JSON-ul primit de la server;
navigator.language, care nu există în Node sau în unele medii de test.
Un cod scris greșit ("ro_RO") dă altă eroare, Incorrect locale information provided. Ambele se rezolvă la fel: verifici valoarea și folosești o rezervă.
De ce apare: cauzele frecvente
1Setare lipsă din profil
const profil = { nume: "Ana" };
const limba = new Intl.Locale(profil.limba);const profil = { nume: "Ana" };
const limba = new Intl.Locale(profil.limba ?? "ro-RO");?? dă codul de rezervă când setarea e undefined sau null.
2Text gol din formular
new Intl.Locale(input.value);new Intl.Locale(input.value.trim() || "ro-RO");Un text gol e tratat ca lipsă. || înlocuiește și textul gol, nu doar undefined.
3Limba browserului în Node
new Intl.Locale(globalThis.navigator?.language);new Intl.Locale(globalThis.navigator?.language ?? Intl.DateTimeFormat().resolvedOptions().locale);resolvedOptions().locale întoarce limba implicită a mediului, disponibilă și în Node.
Repară eroarea, direct în pagină
Profilul utilizatorului nu are încă limba setată, iar new Intl.Locale(profil.limba) dă TypeError: First argument to Intl.Locale constructor can't be empty or missing. Repară crearea obiectului cu o valoare de rezervă "ro-RO" ca programul să afișeze Limbă: ro, regiune: RO.
const profil = { nume: "Ana" };
const limba = new Intl.Locale(profil.limba);
console.log(`Limbă: ${limba.language}, regiune: ${limba.region}`);Limbă: ro, regiune: RO
Indiciu
Folosește operatorul ?? ca să dai "ro-RO" când profil.limba lipsește.
Reparația
const profil = { nume: "Ana" };
const limba = new Intl.Locale(profil.limba ?? "ro-RO");
console.log(`Limbă: ${limba.language}, regiune: ${limba.region}`);De ce merge
profil.limba nu există, deci constructorul primește undefined și refuză să creeze o limbă fără cod. profil.limba ?? "ro-RO" folosește setarea când există și codul de rezervă altfel. Din "ro-RO", Intl.Locale scoate limba ro și regiunea RO. Când utilizatorul își va seta limba, aceeași linie o va folosi pe a lui, fără alte modificări.
Alte forme ale mesajului
TypeError: First argument to Intl.Locale constructor can't be empty or missing at new LocaleTypeError: Intl.Locale constructor requires a string or Locale objectRangeError: Incorrect locale information provided
Cum o eviți pe viitor
- Definește o singură constantă cu limba implicită a aplicației (
const LIMBA = "ro-RO") și folosește-o ca rezervă peste tot. - Validează limba la salvarea setărilor, nu la fiecare afișare.
- Folosește coduri BCP 47, cu cratimă:
ro-RO, nuro_RO. - Scrie un test care pornește aplicația cu profil gol.
Întrebări frecvente
De ce new Intl.NumberFormat(undefined) merge, iar Intl.Locale nu?
Formatoarele acceptă undefined ca „folosește limba implicită”. Intl.Locale descrie o limbă anume, deci nu are sens fără cod.
La ce folosesc Intl.Locale?
Ca să citești bucățile unui cod (language, region), să-l normalizezi (maximize()) sau să-l dai mai departe formatoarelor.
Erori înrudite
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"`. RangeError: Invalid currency code : euro `Intl.NumberFormat` (sau `toLocaleString`) cu `style: "currency"` a primit un cod de monedă care nu are forma corectă: trei litere ISO 4217, ca `"RON"`, `"EUR"`, `"USD"`. Nu merg `"euro"`, `"€"` sau `"lei "`. Dacă lipsește complet, mesajul e `Currency code is required with currency style.` TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. Î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.
