CKTIS / JavaScript
CustomEvent — събития с персонализирани данни
CustomEvent разширява Event с detail, което позволява дефинирани от приложението данни да достигат до слушателите на събитието.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent е интерфейс на Web API от стандарта DOM Standard, а не част от ECMAScript. Конструкторът му приема име на събитие и незадължителни настройки. Чрез опцията detail можете да предадете всяка стойност на JavaScript освен undefined. Ако пропуснете тази опция или изрично подадете undefined, според правилата на Web IDL се използва стойността по подразбиране null. Обектите не се копират.
Създаването на събитие не го изпраща: извикайте dispatchEvent() върху EventTarget. Регистрирайте слушатели с addEventListener(). Изпращането е синхронно. Опциите bubbles, cancelable и composed по подразбиране са false. Проверете наличността на API в целевия браузър; версията на Node в хранилището не я потвърждава.
Примери
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Резултат
score=7 done
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.