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