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.detailCustomEvent.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.