...
Eroare JavaScript · Obiecte și clase

TypeError: Cannot create proxy with a non-object as target or handler

Pe scurt

new Proxy(tinta, handler) cere ca ambele argumente să fie obiecte. Unul dintre ele e un număr, un text, false, null sau undefined. Verifică ce trimiți: de obicei handler-ul e construit condiționat și devine false, sau ținta e o valoare primitivă în loc de obiect.

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

Ce înseamnă

Un Proxy învelește un obiect (tinta) și interceptează operațiile pe el prin funcțiile din handler (get, set, deleteProperty...). Ambele trebuie să fie obiecte: ținta poate fi orice obiect, tablou sau funcție, iar handler-ul un obiect, chiar și gol ({}). Dacă oricare e primitiv (5, "text", false) sau null/undefined, constructorul aruncă Cannot create proxy with a non-object as target or handler.

Mesajul nu îți spune care din cele două e problema, așa că verifică-le pe rând cu typeof. Cauze tipice: un handler construit cu conditie && { ... }, care devine false când condiția e falsă; o variabilă de handler declarată, dar neinițializată; o țintă care e valoarea unei proprietăți (produs.pret) în loc de obiectul întreg; argumentele inversate.

Stiva de apeluri îți arată linia cu new Proxy. Dacă proxy-ul e opțional, decide înainte de new dacă îl creezi sau folosești obiectul direct.

De ce apare: cauzele frecvente

1Handler construit condiționat

Greșit
JavaScript
const handler = optiuni.log && { get(t, k) { console.log(k); return t[k]; } };
const p = new Proxy(produs, handler);
Corect
JavaScript
const handler = { get(t, k) { console.log(k); return t[k]; } };
const p = optiuni.log ? new Proxy(produs, handler) : produs;

Când optiuni.log e fals, && întoarce false. Decizia „cu sau fără proxy” se ia înainte de new Proxy.

2Țintă primitivă

Greșit
JavaScript
const pretUrmarit = new Proxy(produs.pret, {});
Corect
JavaScript
const produsUrmarit = new Proxy(produs, {});

Un proxy învelește un obiect, nu o valoare. Urmărești obiectul și interceptezi proprietatea pret în handler.

3Handler neinițializat

Greșit
JavaScript
let handler;
const p = new Proxy({}, handler);
Corect
JavaScript
const handler = {};
const p = new Proxy({}, handler);

Un handler gol e valid și lasă toate operațiile să treacă neschimbate.

Repară tu

Repară eroarea, direct în pagină

Funcția pregatesteProdus învelește produsul într-un Proxy care afișează proprietățile citite doar când jurnalizarea e activă. Handler-ul e construit cu && și, la al doilea apel, devine false: TypeError: Cannot create proxy with a non-object as target or handler. Repară funcția ca fără jurnalizare să întoarcă obiectul simplu.

Codul care dă eroarea
JavaScript
function pregatesteProdus(produs, jurnal) {
  const handler = jurnal && {
    get(tinta, cheie) {
      console.log(`Citit: ${cheie}`);
      return tinta[cheie];
    },
  };
  return new Proxy(produs, handler);
}

const a = pregatesteProdus({ nume: "Cafea" }, true);
console.log(a.nume);
const b = pregatesteProdus({ nume: "Ceai" }, false);
console.log(b.nume);
După reparație, programul afișează
Citit: nume
Cafea
Ceai
Indiciu

Decide înainte de new Proxy dacă ai nevoie de proxy; handler-ul trebuie să fie mereu obiect.

Alte forme ale mesajului

  • Uncaught TypeError: Cannot create proxy with a non-object as target or handler
  • TypeError: Cannot create proxy with a non-object as target or handler at new Proxy

Cum o eviți pe viitor

  • Nu construi obiecte cu conditie && { ... } când rezultatul trebuie să fie mereu obiect: folosește conditie ? { ... } : {}.
  • Pune proxy-ul pe obiectul întreg, nu pe o proprietate.
  • Scrie o funcție mică urmareste(obj) care verifică typeof obj === "object" && obj !== null înainte de new Proxy.
  • Handler-ul gol {} e o valoare implicită sigură.

Întrebări frecvente

Pot folosi un Proxy pe un tablou sau pe o funcție?

Da, tablourile și funcțiile sunt obiecte. Pe funcții poți intercepta și apelul, cu capcana apply.

De ce mesajul nu spune care argument e greșit?

Motorul verifică ambele argumente cu aceeași regulă și dă un singur mesaj. Afișează typeof tinta și typeof handler înainte de apel ca să afli care e problema.

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.