...
Eroare JavaScript · Numere, BigInt și formatare (Intl)

TypeError: First argument to Intl.Locale constructor can't be empty or missing

Pe scurt

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

Greșit
JavaScript
const profil = { nume: "Ana" };
const limba = new Intl.Locale(profil.limba);
Corect
JavaScript
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

Greșit
JavaScript
new Intl.Locale(input.value);
Corect
JavaScript
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

Greșit
JavaScript
new Intl.Locale(globalThis.navigator?.language);
Corect
JavaScript
new Intl.Locale(globalThis.navigator?.language ?? Intl.DateTimeFormat().resolvedOptions().locale);

resolvedOptions().locale întoarce limba implicită a mediului, disponibilă și în Node.

Repară tu

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.

Codul care dă eroarea
JavaScript
const profil = { nume: "Ana" };

const limba = new Intl.Locale(profil.limba);
console.log(`Limbă: ${limba.language}, regiune: ${limba.region}`);
După reparație, programul afișează
Limbă: ro, regiune: RO
Indiciu

Folosește operatorul ?? ca să dai "ro-RO" când profil.limba lipsește.

Alte forme ale mesajului

  • TypeError: First argument to Intl.Locale constructor can't be empty or missing at new Locale
  • TypeError: Intl.Locale constructor requires a string or Locale object
  • RangeError: 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, nu ro_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

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