Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Jednorazový poslucháč udalostí s voľbou `once`

Pomocou `{ once: true }` sa obslužná funkcia zavolá najviac raz na registráciu. Registrácia sa odstráni ešte pred zavolaním funkcie.

Verzia: Current web platform; runtime support varies

Syntax

target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);

Voľba once metódy EventTarget.addEventListener patrí do objektu volieb odovzdávaného ako tretí argument. Pri { once: true } sa obslužná funkcia v rámci danej registrácie zavolá najviac raz. Ak once vynecháte, platí false. Samotné true ako tretí argument nastaví capture, nie once.

API odstráni registráciu tesne pred zavolaním obslužnej funkcie. Vnorené volanie dispatchEvent() s novou udalosťou rovnakého typu preto nemôže funkciu zavolať prostredníctvom tej istej registrácie. Vyvolaná výnimka registráciu neobnoví. Ak sa k funkcii nedostane žiadna udalosť, samotné once registráciu neodstráni.

Opätovné volanie addEventListener() na tom istom cieli s rovnakým typom udalosti, rovnakou funkciou a rovnakou hodnotou capture existujúcu registráciu nezmení, ani keď je hodnota once iná. Ak chcete nastavenie zmeniť, najprv zavolajte removeEventListener() so zodpovedajúcim typom, funkciou a hodnotou capture a potom funkciu znova zaregistrujte.

EventTarget je rozhranie DOM poskytované hostiteľským prostredím a nie je súčasťou ECMAScriptu 2024. Overte si, či cieľové prostredie vykonávania túto voľbu podporuje.

Príklady

{
  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}`);
}

Výsledok

calls: 1

Prvé volanie `dispatchEvent()` spustí obslužnú funkciu. Vnorené ani nasledujúce volanie ju znova nespustí. Očakávaný výstup: `calls: 1`.

Súvisiace lekcie

  • JavaScript · Lekcia 39 · Pokročilá · Verzia: 4

Zdroje