Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

CustomEvent.detail — podatki dogodka po meri

CustomEvent.detail razkrije podatke, podane ob ustvarjanju dogodka. Privzeta vrednost je null; objekti se posredujejo brez kloniranja.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const event = new CustomEvent(type, { detail: value });
event.detail

CustomEvent.detail je lastnost primerka CustomEvent, ki vsebuje podatke, nastavljene z možnostjo detail konstruktorja. Če možnost detail izpustite ali jo izrecno nastavite na undefined, Web IDL uporabi privzeto vrednost null, zato velja event.detail === null.

Lastnost je samo za branje, vendar shranjenega objekta ne zamrzne. Objekt se ne klonira: sprememba event.detail.count spremeni isti objekt, ki je bil posredovan konstruktorju.

Poslušalnik prebere podatke prek event.detail. Primer prikazuje skupno referenco in privzeto vrednost null. To je vmesnik DOM, ne funkcija jezika ECMAScript; prisotnost Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.

Primeri

const target = new EventTarget();
const payload = { count: 1 };

 target.addEventListener("count-change", (event) => {
  console.log(event.detail === payload);
  event.detail.count += 1;
});

target.dispatchEvent(new CustomEvent("count-change", { detail: payload }));
console.log(payload.count);
console.log(new CustomEvent("empty").detail);

Rezultat

true
2
null

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri