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

TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received type string ('comanda')

Pe scurt

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

Greșit
JavaScript
comenzi.dispatchEvent("comanda", { id: 1042 });
Corect
JavaScript
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

Greșit
JavaScript
target.dispatchEvent({ type: "gata" });
Corect
JavaScript
target.dispatchEvent(new Event("gata"));

dispatchEvent verifică tipul obiectului, nu doar dacă are câmpul type.

3Ai nevoie de fapt de EventEmitter

Greșit
JavaScript
const bus = new EventTarget();
bus.dispatchEvent("comanda", date);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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 });
După reparație, programul afișează
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.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received an instance of Object
  • TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received undefined
  • TypeError: 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: addEventListener primește numele, dispatchEvent primește un Event.
  • Pune datele în detail al unui CustomEvent și citește-le cu e.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

← 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.