...
Eroare JavaScript · Obiecte și clase

TypeError: Object prototype may only be an Object or null: undefined

Pe scurt

Object.create(x) sau Object.setPrototypeOf(obj, x) a primit ca prototip ceva ce nu e obiect și nici null: de obicei undefined, dintr-un nume greșit sau dintr-o variabilă încă neîncărcată. Verifică valoarea dată ca prototip; pentru un obiect fără prototip, folosește explicit null.

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

Ce înseamnă

Fiecare obiect are un prototip, de unde moștenește metode. Object.create(proto) creează un obiect nou cu prototipul dat, iar Object.setPrototypeOf(obj, proto) schimbă prototipul unui obiect existent. Prototipul poate fi doar un obiect sau null. Orice altceva (undefined, un număr, un text) dă această TypeError, iar mesajul îți arată la final valoarea primită: : undefined, : 5, : Ana.

Aproape mereu valoarea e undefined pentru că:

  • ai scris greșit cheia sau variabila (prototipuri.Animal în loc de prototipuri.animal);
  • ai dat Clasa.prototype al unei valori care nu e funcție (obiect.prototype e undefined la obiectele obișnuite);
  • importul sau scriptul care definește prototipul nu s-a încărcat încă.

Caută în stivă linia cu Object.create sau setPrototypeOf și afișează valoarea transmisă cu console.log chiar înainte.

De ce apare: cauzele frecvente

1Cheie scrisă greșit

Greșit
JavaScript
const prototipuri = { animal: { descrie() { } } };
const caine = Object.create(prototipuri.Animal);
Corect
JavaScript
const prototipuri = { animal: { descrie() { } } };
const caine = Object.create(prototipuri.animal);

Cheia cu A mare nu există, deci prototipul era undefined.

2.prototype pe un obiect obișnuit

Greșit
JavaScript
const Animal = { sunet: "..." };
const pisica = Object.create(Animal.prototype);
Corect
JavaScript
const Animal = { sunet: "..." };
const pisica = Object.create(Animal);

Doar funcțiile și clasele au .prototype; un obiect literal e el însuși prototipul.

3Obiect fără prototip scris cu undefined

Greșit
JavaScript
const dictionar = Object.create(undefined);
Corect
JavaScript
const dictionar = Object.create(null);

null e valoarea acceptată pentru „fără prototip”; undefined nu.

Repară tu

Repară eroarea, direct în pagină

Programul creează un câine care moștenește metoda descrie din prototipul animal, dar se oprește cu TypeError: Object prototype may only be an Object or null: undefined. Repară crearea obiectului ca programul să afișeze Rex face ham.

Codul care dă eroarea
JavaScript
const prototipuri = {
  animal: {
    descrie() {
      return `${this.nume} face ${this.sunet}`;
    },
  },
};

const caine = Object.create(prototipuri.Animal);
caine.nume = "Rex";
caine.sunet = "ham";

console.log(caine.descrie());
După reparație, programul afișează
Rex face ham
Indiciu

Compară cheia din prototipuri cu cea folosită la Object.create: literele mari contează.

Alte forme ale mesajului

  • TypeError: Object prototype may only be an Object or null: 5
  • TypeError: Object prototype may only be an Object or null: [object Object] at Function.create
  • TypeError: Object prototype may only be an Object or null: undefined at Function.setPrototypeOf

Cum o eviți pe viitor

  • Preferă clasele (class Caine extends Animal) în loc de Object.create manual.
  • Când folosești Object.create, transmite obiectul prototip, nu .prototype al lui (decât dacă e o funcție sau o clasă).
  • Pentru dicționare fără chei moștenite, folosește Object.create(null) sau, mai bine, Map.
  • Verifică importurile: un export lipsă produce undefined fără altă eroare.

Întrebări frecvente

Ce diferență e între {} și Object.create(null)?

{} moștenește din Object.prototype (are toString, hasOwnProperty). Object.create(null) nu moștenește nimic, deci e un dicționar „curat”, fără chei ascunse.

Pot da o clasă direct la Object.create?

Poți, dar obiectul va moșteni proprietățile statice ale clasei, nu metodele instanțelor. Pentru instanțe ai nevoie de Object.create(Clasa.prototype) sau, simplu, de new Clasa().

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.