TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received type string ('comanda')
dispatchEvent din EventTarget primește un obiect Event, nu numele evenimentului ca text (asta e stilul lui EventEmitter.emit). Scrie target.dispatchEvent(new Event("comanda")), iar pentru date atașate new CustomEvent("comanda", { detail: { ... } }).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Node are două sisteme de evenimente. EventEmitter (modulul events) folosește emitter.emit("nume", date) și emitter.on("nume", fn). EventTarget, același API ca în browser, folosește target.addEventListener("nume", fn) și target.dispatchEvent(eveniment), unde eveniment trebuie să fie un obiect Event (sau derivat din el, ca CustomEvent).
Mesajul spune că dispatchEvent a primit altceva: un text (Received type string ('comanda')), un obiect simplu (Received an instance of Object) sau undefined. Se întâmplă când amesteci cele două stiluri, de obicei scriind dispatchEvent("nume", date) ca la emit.
EventTarget apare în Node la AbortSignal, la BroadcastChannel, la MessagePort și în codul scris să meargă la fel și în browser. Datele se pun în detail al unui CustomEvent și se citesc în ascultător cu e.detail.
De ce apare: cauzele frecvente
1dispatchEvent apelat ca emit
comenzi.dispatchEvent("comanda", { id: 1042 });comenzi.dispatchEvent(new CustomEvent("comanda", { detail: { id: 1042 } }));CustomEvent e un Event cu un câmp detail pentru date, exact ce așteaptă dispatchEvent.
2Obiect simplu în loc de Event
target.dispatchEvent({ type: "gata" });target.dispatchEvent(new Event("gata"));dispatchEvent verifică tipul obiectului, nu doar dacă are câmpul type.
3Ai nevoie de fapt de EventEmitter
const bus = new EventTarget();
bus.dispatchEvent("comanda", date);const EventEmitter = require("events");
const bus = new EventEmitter();
bus.on("comanda", (date) => { /* ... */ });
bus.emit("comanda", date);Pentru evenimente interne ale unei aplicații Node, EventEmitter e mai simplu: trimiți datele direct, fără obiect Event.
Repară eroarea, direct în pagină
Programul folosește un EventTarget pentru comenzile noi, dar trimite evenimentul ca la EventEmitter și dă TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Trimite comanda ca CustomEvent, cu datele în detail, ca ascultătorul să afișeze comanda.
const comenzi = new EventTarget();
comenzi.addEventListener("comanda", (e) => {
console.log(`Comandă nouă: #${e.detail.id}, ${e.detail.total} lei`);
});
comenzi.dispatchEvent("comanda", { id: 1042, total: 125 });
comenzi.dispatchEvent("comanda", { id: 1043, total: 89 });Comandă nouă: #1042, 125 lei Comandă nouă: #1043, 89 lei
Indiciu
new CustomEvent("comanda", { detail: { id: 1042, total: 125 } }) se dă ca singur argument lui dispatchEvent.
Reparația
const comenzi = new EventTarget();
comenzi.addEventListener("comanda", (e) => {
console.log(`Comandă nouă: #${e.detail.id}, ${e.detail.total} lei`);
});
comenzi.dispatchEvent(new CustomEvent("comanda", { detail: { id: 1042, total: 125 } }));
comenzi.dispatchEvent(new CustomEvent("comanda", { detail: { id: 1043, total: 89 } }));De ce merge
EventTarget.dispatchEvent acceptă un singur argument, un obiect Event; numele evenimentului e în interiorul lui, nu un parametru separat. CustomEvent e un Event care poartă date în detail, iar ascultătorul le citește cu e.detail.id și e.detail.total. Al doilea argument din varianta greșită nici nu ar fi fost folosit: e un obicei luat de la EventEmitter.emit.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received an instance of ObjectTypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received undefinedTypeError: Failed to execute 'dispatchEvent' on 'EventTarget': parameter 1 is not of type 'Event'.
Cum o eviți pe viitor
- Alege un singur stil de evenimente pentru un modul:
EventEmitterîn codul Node,EventTargetîn codul comun cu browserul. - Pentru
EventTarget, ține minte perechea:addEventListenerprimește numele,dispatchEventprimește unEvent. - Pune datele în
detailal unuiCustomEventși citește-le cue.detail.
Întrebări frecvente
CustomEvent există în Node?
Da, ca obiect global din Node 19 (în versiunile 18 era experimental). În versiunile mai vechi poți crea o clasă proprie care extinde Event și are un câmp cu date.
Care e diferența practică între EventEmitter și EventTarget?
EventEmitter trimite orice argumente ascultătorilor și are evenimentul special error. EventTarget trimite un singur obiect Event, are opțiuni ca once și signal la addEventListener și e identic cu cel din browser.
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_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. TypeError: this.emit is not a function În interiorul unui callback scris cu function, this nu mai este obiectul tău EventEmitter, ci altceva (un Timeout, un stream, undefined). Folosește o funcție săgeată, care păstrează this din metoda clasei, sau salvează obiectul într-o variabilă înainte de callback. Î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.
