...
Eroare Testare automată · Structura testului: fixtures, hooks și importuri

TypeError: Cannot destructure property 'email' of 'user' as it is undefined.

Pe scurt

Încerci să scoți câmpuri (const { email } = user) dintr-o valoare undefined. În teste API, de obicei răspunsul a fost o eroare și nu conține obiectul așteptat; în funcțiile ajutătoare, ai apelat funcția fără obiectul de argumente. Verifică răspunsul cu toBeOK() înainte și dă funcției argumentele.

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

Ce înseamnă

Destructurarea (const { email } = user sau function f({ page })) citește proprietăți dintr-un obiect. Când valoarea e undefined sau null, JavaScript nu are de unde citi și aruncă Cannot destructure property 'email' of 'user' as it is undefined. Mesajul îți dă și numele proprietății (email), și numele variabilei goale (user).

În testele de API, cauza tipică e un răspuns de eroare: login-ul a întors 401 { error: "..." }, deci corp.user nu există. În testele UI, apare când o funcție ajutătoare definită ca async function login({ page, email }) e apelată fără obiect (login()), sau când un fixture din test.extend are semnătura greșită. Când variabila e chiar argumentul funcției, mesajul devine Cannot destructure property 'page' of 'undefined' as it is undefined. Pentru răspunsuri, verifică statusul înainte să citești câmpurile.

De ce apare: cauzele frecvente

1Răspunsul API e o eroare

Greșit
JavaScript
const r = await request.post('/api/login', { data: { email, password: 'gresit' } });
const { user } = await r.json();
const { email: e } = user;
Corect
JavaScript
const r = await request.post('/api/login', { data: { email, password: 'Parola123!' } });
await expect(r).toBeOK();
const { user } = await r.json();

La 401, corpul e { error }, fără user. toBeOK oprește testul cu un mesaj clar înainte de destructurare.

2Funcție ajutătoare apelată fără argumente

Greșit
JavaScript
async function deschideCos({ page }) { await page.goto('/#/cos'); }
await deschideCos();
Corect
JavaScript
async function deschideCos({ page }) { await page.goto('/#/cos'); }
await deschideCos({ page });

Funcția așteaptă un obiect din care scoate page. Fără argument, primește undefined.

3Numele cheii diferă în răspuns

Greșit
JavaScript
const { data } = await r.json();
const { id } = data;
Corect
JavaScript
const corp = await r.json();
console.log(corp);
const { id } = corp;

Dacă API-ul nu învelește rezultatul în data, corp.data e undefined. Afișează o dată răspunsul ca să-i vezi forma.

Repară tu

Repară eroarea, direct în pagină

Testul login prin API întoarce utilizatorul pică cu TypeError: Cannot destructure property 'email' of 'user' as it is undefined.: login-ul eșuează (parola e scrisă cu literă mică), iar corpul răspunsului nu are user. Repară parola (Parola123!), adaugă verificarea răspunsului cu toBeOK() înainte de json() și afișează emailul utilizatorului.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('login prin API întoarce utilizatorul', async ({ request }) => {
  const raspuns = await request.post('/api/login', {
    data: { email: 'ana@shoprapid.ro', password: 'parola123!' }
  });
  const { user } = await raspuns.json();
  const { email } = user;
  expect(email).toBe('ana@shoprapid.ro');
});
Indiciu

Răspunsul unui login eșuat nu conține utilizatorul.

Alte forme ale mesajului

  • TypeError: Cannot destructure property 'page' of 'undefined' as it is undefined.
  • TypeError: Cannot destructure property 'token' of '(intermediate value)' as it is undefined.
  • TypeError: Cannot destructure property 'id' of 'data' as it is undefined.
  • TypeError: Cannot destructure property 'email' of 'user' as it is null.

Cum o eviți pe viitor

  • Pune await expect(raspuns).toBeOK() înainte de orice citire din json().
  • Afișează o dată răspunsul când scrii testul, ca să știi forma exactă.
  • Pentru funcții ajutătoare cu obiect de argumente, dă o valoare implicită ca mesajul să fie clar: function f({ page } = {}) { if (!page) throw new Error('lipsește page'); }.

Întrebări frecvente

De ce nu primesc direct mesajul serverului?

Pentru că testul a mers mai departe după răspunsul de eroare. Cu toBeOK() înainte, raportul arată statusul și corpul răspunsului (401 Unauthorized), deci cauza reală.

Ce înseamnă „(intermediate value)”?

Valoarea nu avea un nume de variabilă, de exemplu const { token } = await r.json() când json() întoarce undefined. Cauza e aceeași: nu există obiectul din care destructurezi.

Erori înrudite

← Toate erorile Testare automată

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ță Testare automată de la zero, cu exerciții la fiecare lecție

Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.