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

RangeError: Invalid code point NaN

Pe scurt

String.fromCodePoint a primit o valoare care nu e un cod Unicode valid: NaN, un număr negativ, cu zecimale sau peste 0x10FFFF. De obicei codul hexazecimal (ca 021B) a fost transformat cu Number() în loc de parseInt(cod, 16), sau un calcul a ieșit din interval. Verifică numărul înainte de apel.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

String.fromCodePoint(n) creează caracterul cu codul Unicode n. Codurile valide sunt numere întregi de la 0 la 0x10FFFF (1114111). Orice altceva, adică NaN, un număr negativ, unul cu zecimale sau unul prea mare, dă Invalid code point <valoare>. Valoarea din mesaj îți spune exact ce a primit funcția.

NaN apare aproape mereu la conversia unui cod scris în hexazecimal: Number("021B") dă NaN, pentru că B nu e cifră zecimală, iar Number("00E9") dă chiar 0 (notație științifică). Codurile de forma U+021B trebuie citite cu parseInt(cod, 16), fără prefixul U+.

Numerele negative sau prea mari apar în calcule: deplasarea literelor într-un cifru, scăderea dintr-un cod fără verificare, un index greșit. Spre deosebire de fromCodePoint, String.fromCharCode nu aruncă eroare: trunchiază în tăcere valoarea, deci poate ascunde problema.

De ce apare: cauzele frecvente

1Cod hexazecimal citit ca zecimal

Greșit
JavaScript
const cod = "U+021B";
String.fromCodePoint(Number(cod.slice(2)));
Corect
JavaScript
const cod = "U+021B";
String.fromCodePoint(parseInt(cod.slice(2), 16));

Codurile Unicode se scriu în baza 16. parseInt(..., 16) le citește corect: 0x21B e litera ț.

2Calcul care iese din interval

Greșit
JavaScript
const litera = String.fromCodePoint("a".codePointAt(0) - 200);
Corect
JavaScript
const cod = "a".codePointAt(0) - 200;
const litera = cod >= 0 ? String.fromCodePoint(cod) : "?";

Un cod negativ nu există. Verifici intervalul sau folosești aritmetică modulară, ca la un cifru.

3Valoare cu zecimale

Greșit
JavaScript
String.fromCodePoint(65 + 0.5);
Corect
JavaScript
String.fromCodePoint(Math.round(65 + 0.5));

Codurile sunt numere întregi. Rotunjește explicit dacă valoarea vine dintr-un calcul.

Repară tu

Repară eroarea, direct în pagină

Programul primește coduri Unicode în forma U+021B și le transformă în litere, dar citește partea hexazecimală cu Number(), iar String.fromCodePoint aruncă RangeError: Invalid code point NaN. Repară conversia ca programul să afișeze literele ț și ă.

Codul care dă eroarea
JavaScript
const coduri = ["U+021B", "U+0103"];

const litere = coduri.map((cod) => String.fromCodePoint(Number(cod.slice(2))));

console.log(`Litere: ${litere.join(", ")}`);
După reparație, programul afișează
Litere: ț, ă
Indiciu

Codurile Unicode sunt în baza 16: parseInt are un al doilea argument pentru bază.

Alte forme ale mesajului

  • RangeError: Invalid code point -1
  • RangeError: Invalid code point 1114112
  • RangeError: -1 is not a valid code point
  • RangeError: Invalid code point 65.5

Cum o eviți pe viitor

  • Citește codurile Unicode cu parseInt(cod, 16) și verifică rezultatul cu Number.isInteger.
  • Validează intervalul 0 – 0x10FFFF înainte de String.fromCodePoint.
  • La cifruri și deplasări de litere, folosește operatorul % ca să rămâi în alfabet.
  • Preferă fromCodePoint în locul lui fromCharCode: măcar te anunță când valoarea e greșită.

Întrebări frecvente

De ce String.fromCharCode nu dă eroare cu aceeași valoare?

fromCharCode transformă valoarea într-un număr pe 16 biți și ignoră restul, deci întoarce un caracter greșit fără niciun avertisment. fromCodePoint verifică valoarea și aruncă eroare.

Cum obțin codul unei litere?

Cu "ț".codePointAt(0), care întoarce 539. În hexazecimal: (539).toString(16) dă 21b.

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.