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

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

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

Източници