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

CKTIS / JavaScript

EventTarget.dispatchEvent(): синхронно изпращане на събития

dispatchEvent(event) изпраща събитие към цел синхронно. Булевият резултат показва дали събитието е отменено, а не дали има слушатели.

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

Синтаксис

target.dispatchEvent(event)

target.dispatchEvent(event) изпраща обект Event към EventTarget. Слушателите се извикват синхронно; методът не изчаква приключването на асинхронната работа, започната от слушателите. Събитието има isTrusted === false.

Резултатът е false, когато събитието е отменено, а в противен случай е true. preventDefault() отменя събитието само при cancelable: true и извън пасивен слушател. stopPropagation() не означава отмяна на събитието.

В DOM дърво се прилагат прихващането и евентуалното разпространение нагоре (bubbles). Самостоятелен new EventTarget() няма родител. Изключенията на слушателите се съобщават, но не се разпространяват до извикващия. Повторното изпращане на обекта, който в момента се изпраща, предизвиква InvalidStateError.

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

Примери

const target = new EventTarget();
const log = [];

target.addEventListener("save", (event) => {
  log.push("listener");
  event.preventDefault();
});

log.push("before");
const accepted = target.dispatchEvent(
  new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));

Резултат

before | listener | after: false

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

Източници