...
Eroare Node.js · EventEmitter și stream-uri

Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat')

Pe scurt

Un EventEmitter a emis evenimentul 'error' și nu are niciun ascultător pentru el, așa că Node oprește programul. Adaugă emitter.on("error", (err) => {...}) înainte de emit și emite obiecte Error, nu texte.

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

Ce înseamnă

Evenimentul 'error' are o regulă specială în Node: dacă un EventEmitter emite 'error' și nu există niciun ascultător pentru el, emitterul aruncă eroarea ca excepție și, dacă nu o prinde nimeni, programul se oprește. E un mecanism de siguranță: erorile nu trebuie să treacă neobservate.

Forma ERR_UNHANDLED_ERROR: Unhandled error. ('...') apare când ai emis ceva care nu e un obiect Error (un text, un obiect simplu); între paranteze vezi valoarea emisă. Dacă emiți new Error("..."), Node aruncă direct eroarea ta și afișează Emitted 'error' event at: cu locul emiterii.

Aceeași regulă se aplică stream-urilor, serverelor și socket-urilor, care sunt tot EventEmitter: un stream de fișier fără on("error") oprește programul dacă fișierul lipsește.

De ce apare: cauzele frecvente

1Lipsește ascultătorul pentru 'error'

Greșit
JavaScript
const senzor = new EventEmitter();
senzor.emit("error", new Error("Senzor deconectat"));
Corect
JavaScript
const senzor = new EventEmitter();
senzor.on("error", (err) => console.log(`Problemă: ${err.message}`));
senzor.emit("error", new Error("Senzor deconectat"));

Cu un ascultător înregistrat, eroarea e livrată funcției tale în loc să oprească programul.

2Emiți un text în loc de Error

Greșit
JavaScript
this.emit("error", "Senzor deconectat");
Corect
JavaScript
this.emit("error", new Error("Senzor deconectat"));

Un obiect Error are mesaj și stivă; ascultătorii pot folosi err.message ca la orice eroare.

3Ascultătorul e adăugat prea târziu

Greșit
JavaScript
senzor.emit("error", new Error("x"));
senzor.on("error", trateaza);
Corect
JavaScript
senzor.on("error", trateaza);
senzor.emit("error", new Error("x"));

emit e sincron: livrează evenimentul doar ascultătorilor care există în acel moment.

Repară tu

Repară eroarea, direct în pagină

Clasa Termostat emite 'error' când temperatura citită e invalidă, dar nimeni nu ascultă evenimentul și programul se oprește cu Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat'). Emite un obiect Error și adaugă un ascultător pentru 'error', ca programul să proceseze toate cele trei citiri.

Codul care dă eroarea
JavaScript
const EventEmitter = require("events");

class Termostat extends EventEmitter {
  citeste(valoare) {
    if (valoare === null) {
      this.emit("error", "Senzor deconectat");
      return;
    }
    this.emit("temperatura", valoare);
  }
}

const termostat = new Termostat();
termostat.on("temperatura", (t) => console.log(`Temperatura: ${t}°C`));

termostat.citeste(21.5);
termostat.citeste(null);
termostat.citeste(22);
După reparație, programul afișează
Temperatura: 21.5°C
Avertizare: Senzor deconectat
Temperatura: 22°C
Indiciu

termostat.on("error", (err) => ...) trebuie înregistrat înainte de prima citire.

Alte forme ale mesajului

  • Error [ERR_UNHANDLED_ERROR]: Unhandled error. ({ cod: 500 })
  • Error: Senzor deconectat Emitted 'error' event at:
  • Error [ERR_UNHANDLED_ERROR]: Unhandled error. (undefined)

Cum o eviți pe viitor

  • Pentru orice EventEmitter, stream, server sau socket pe care îl creezi, adaugă on("error", ...).
  • Emite doar obiecte Error pe evenimentul 'error'.
  • Înregistrează ascultătorii înainte să pornești operațiile care pot emite evenimente.
  • În clasele tale care extind EventEmitter, documentează ce evenimente emit, inclusiv 'error'.

Întrebări frecvente

De ce doar evenimentul error oprește programul?

E singurul eveniment cu regulă specială. Celelalte evenimente fără ascultători sunt pur și simplu ignorate; o eroare ignorată ar însemna o problemă ascunsă, așa că Node preferă să se oprească.

Cum aștept o eroare cu await?

events.once(emitter, "gata") întoarce o promisiune care se respinge dacă emitterul emite 'error' înainte de 'gata', deci o prinzi cu try/catch.

Erori înrudite

← Toate erorile Node.js

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

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.