Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat')
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'
const senzor = new EventEmitter();
senzor.emit("error", new Error("Senzor deconectat"));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
this.emit("error", "Senzor deconectat");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
senzor.emit("error", new Error("x"));
senzor.on("error", trateaza);senzor.on("error", trateaza);
senzor.emit("error", new Error("x"));emit e sincron: livrează evenimentul doar ascultătorilor care există în acel moment.
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.
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);Temperatura: 21.5°C Avertizare: Senzor deconectat Temperatura: 22°C
Indiciu
termostat.on("error", (err) => ...) trebuie înregistrat înainte de prima citire.
Reparația
const EventEmitter = require("events");
class Termostat extends EventEmitter {
citeste(valoare) {
if (valoare === null) {
this.emit("error", new Error("Senzor deconectat"));
return;
}
this.emit("temperatura", valoare);
}
}
const termostat = new Termostat();
termostat.on("temperatura", (t) => console.log(`Temperatura: ${t}°C`));
termostat.on("error", (err) => console.log(`Avertizare: ${err.message}`));
termostat.citeste(21.5);
termostat.citeste(null);
termostat.citeste(22);De ce merge
Pentru evenimentul 'error', EventEmitter verifică dacă există ascultători; dacă nu, aruncă eroarea, iar programul se oprește înainte de a treia citire. Cu on("error", ...) eroarea devine un eveniment obișnuit, tratat de funcția ta, și execuția continuă. Emiterea unui new Error(...) în loc de text îți dă err.message și stiva de apeluri, la fel ca la orice altă eroare din Node.
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
Errorpe 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
TypeError [ERR_INVALID_ARG_TYPE]: The "listener" argument must be of type function. Received undefined Ai dat lui on, once sau addListener rezultatul unei funcții în loc de funcția însăși, de obicei emitter.on("comanda", trimiteEmail()). Scoate parantezele: emitter.on("comanda", trimiteEmail), sau folosește o funcție săgeată. Error [ERR_STREAM_WRITE_AFTER_END]: write after end Ai scris într-un stream (fișier sau răspuns HTTP) după ce l-ai închis cu end(). După end() nu mai poți scrie. Scrie toate datele întâi și apelează end() o singură dată, la final; ca să faci ceva după scriere, ascultă evenimentul 'finish'. UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. Î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.
