База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

CustomEvent.detail — данни на персонализирано събитие

CustomEvent.detail предоставя данните, зададени при създаването на събитие. Стойността по подразбиране е null; обектите се предават без клониране.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

CustomEvent.detail е свойство на екземпляр на CustomEvent, което съдържа данните, зададени чрез опцията detail на конструктора. Ако опцията detail е пропусната или изрично е зададена на undefined, Web IDL прилага стойността по подразбиране null, така че event.detail === null.

Свойството е само за четене, но не замразява съхранения обект. Обектът не се клонира: промяна на event.detail.count променя същия обект, който е подаден на конструктора.

Слушателят чете данните чрез event.detail. Примерът показва споделената препратка и стойността по подразбиране null. Това е DOM интерфейс, а не функция на езика ECMAScript; наличието на Node 24 в хранилище не доказва поддръжка в браузърите.

Примери

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);

Резултат

true
2
null

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници