TypeError: admin is not a symbol
Symbol.keyFor a primit un text (sau alt tip) în loc de un simbol. Funcția întoarce cheia unui simbol din registrul global creat cu Symbol.for("cheie"). Dă-i simbolul, nu textul: Symbol.keyFor(Symbol.for("admin")), sau folosește direct textul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Symbol.for("admin") creează (sau găsește) un simbol în registrul global de simboluri, identificat prin cheia "admin". Operația inversă, Symbol.keyFor(simbol), primește un simbol și întoarce cheia lui (sau undefined dacă simbolul nu e din registru). Dacă îi dai altceva decât un simbol (un text, undefined, un obiect), funcția aruncă X is not a symbol, unde X e valoarea primită: admin is not a symbol, undefined is not a symbol, #<Object> is not a symbol.
Se întâmplă când datele trec printr-o serializare: simbolurile nu ajung în JSON, așa că după JSON.parse ai doar texte. Sau când o funcție primește uneori simbolul și alteori numele lui.
Decide ce circulă prin aplicație: simbolul sau textul. Dacă e textul, nu ai nevoie de keyFor; dacă ai nevoie de simbol, obține-l cu Symbol.for(text).
De ce apare: cauzele frecvente
1Text dat în loc de simbol
const rol = "admin";
console.log(Symbol.keyFor(rol));const rol = Symbol.for("admin");
console.log(Symbol.keyFor(rol));keyFor lucrează doar cu simboluri. Symbol.for transformă textul în simbolul din registru.
2Valoare citită din JSON
const user = JSON.parse('{"rol":"admin"}');
Symbol.keyFor(user.rol);const user = JSON.parse('{"rol":"admin"}');
const rol = user.rol;După JSON ai deja textul; cheia simbolului e chiar acest text.
3Proprietate lipsă
Symbol.keyFor(setari.rol);if (typeof setari.rol === "symbol") Symbol.keyFor(setari.rol);Dacă proprietatea lipsește, primești undefined is not a symbol. Verificarea cu typeof evită apelul.
Repară eroarea, direct în pagină
Funcția numeRol afișează numele unui rol definit cu Symbol.for, dar al doilea apel îi trimite textul "admin", iar codul dă TypeError: admin is not a symbol. Repară funcția ca să accepte atât simbolul, cât și textul, iar programul să afișeze Rol: editor și Rol: admin.
const EDITOR = Symbol.for("editor");
function numeRol(rol) {
return `Rol: ${Symbol.keyFor(rol)}`;
}
console.log(numeRol(EDITOR));
console.log(numeRol("admin"));Rol: editor Rol: admin
Indiciu
Dacă typeof rol este "symbol", folosește Symbol.keyFor; altfel, textul e deja numele.
Reparația
const EDITOR = Symbol.for("editor");
function numeRol(rol) {
const nume = typeof rol === "symbol" ? Symbol.keyFor(rol) : rol;
return `Rol: ${nume}`;
}
console.log(numeRol(EDITOR));
console.log(numeRol("admin"));De ce merge
Symbol.keyFor acceptă doar simboluri și aruncă eroare pentru orice altceva. Verificarea cu typeof rol === "symbol" alege calea potrivită: pentru simbolul din registru citește cheia (editor), iar pentru text folosește direct valoarea (admin). Funcția acceptă acum ambele forme, iar codul care o apelează nu mai trebuie să știe dacă are un simbol sau un text.
Alte forme ale mesajului
TypeError: undefined is not a symbolTypeError: #<Object> is not a symbolTypeError: 1 is not a symbol
Cum o eviți pe viitor
- Simbolurile nu supraviețuiesc serializării (JSON,
localStorage, rețea): pentru date care circulă, folosește texte. - Verifică tipul cu
typeof valoare === "symbol"în funcțiile care acceptă ambele forme. - Ține simbolurile aplicației într-un singur modul (
export const ADMIN = Symbol.for("admin")) și importă-le de acolo.
Întrebări frecvente
Care e diferența dintre Symbol("x") și Symbol.for("x")?
Symbol("x") creează mereu un simbol nou, unic. Symbol.for("x") caută în registrul global și întoarce același simbol pentru aceeași cheie, deci Symbol.keyFor funcționează doar pe acestea.
Ce întoarce keyFor pentru un simbol creat cu Symbol("x")?
undefined, fără eroare. Eroarea apare doar când valoarea nu e simbol deloc.
Erori înrudite
TypeError: Cannot convert a Symbol value to a string Ai pus un `Symbol` într-un text cu `+` sau într-un template literal. Simbolurile nu se transformă automat în text. Folosește `String(simbol)`, `simbol.toString()` sau `simbol.description` dacă vrei să-l afișezi. TypeError: Invalid value used as weak map key WeakMap acceptă drept chei doar obiecte (și simboluri neînregistrate), nu texte, numere sau null. Ai pus probabil un ID sau un nume ca cheie. Folosește un Map obișnuit pentru chei simple, sau păstrează WeakMap și folosește obiectul însuși ca cheie. TypeError: calculeazaTotal is not a function Apelezi cu `()` ceva care nu este o funcție: un număr, un text, un obiect sau `undefined`. De obicei numele metodei e scris greșit, ai suprascris funcția cu o variabilă cu același nume sau metoda nu există pe acel tip de valoare. Verifică ce conține de fapt numele din mesaj. Î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.
