CKTIS / JavaScript
Еднократни слушатели на събития с `once`
С `{ once: true }` функцията за обработка на събития се извиква най-много веднъж за всяка регистрация. Регистрацията се премахва преди извикването.
Версия: Current web platform; runtime support varies
Синтаксис
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);Опцията once на EventTarget.addEventListener е свойство на обекта с опции, подаден като трети аргумент. С { once: true } функцията за обработка може да се извика най-много веднъж за тази регистрация. Ако пропуснеш once, стойността е false. Ако подадеш само true като трети аргумент, задаваш capture, а не once.
API премахва регистрацията непосредствено преди да извика функцията. Затова вложено извикване на dispatchEvent() с ново събитие от същия тип не може да извика функцията чрез същата регистрация. Хвърлено изключение не възстановява регистрацията. Ако до функцията не достигне събитие, once сама по себе си не премахва регистрацията.
При същия целеви обект повторно извикване на addEventListener() със същия тип събитие, същата функция и същата стойност на capture не променя съществуващата регистрация, дори стойността на once да е различна. За да промениш настройката, първо извикай removeEventListener() със съответстващите тип, функция и стойност на capture, а после регистрирай функцията отново.
EventTarget е интерфейс на DOM, предоставян от хост средата, и не е част от ECMAScript 2024. Провери дали целевата среда за изпълнение поддържа тази опция.
Примери
{
const target = new EventTarget();
let calls = 0;
target.addEventListener("ready", () => {
calls += 1;
if (calls === 1) target.dispatchEvent(new Event("ready"));
}, { once: true });
target.dispatchEvent(new Event("ready"));
target.dispatchEvent(new Event("ready"));
console.log(`calls: ${calls}`);
}Резултат
calls: 1
Първото извикване на `dispatchEvent()` стартира функцията за обработка. Нито вложеното, нито следващото извикване я стартира отново. Очакван изход: `calls: 1`.
Свързани уроци
- JavaScript · Урок 39 · Напреднало · Версия: 4