Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Animation.finished — obljuba o dokončanju animacije

Animation.finished omogoča, da z await počakaš na dokončanje animacije in upoštevaš morebitni preklic.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const completedAnimation = await animation.finished;

Animation.finished je lastnost samo za branje, ki vrne Promise<Animation>. Ko animacija doseže stanje finished, tudi s klicem finish(), se lahko obljuba izpolni z objektom animacije. Ni logična vrednost in ni metoda.

Ko animacija zapusti stanje finished, se trenutna obljuba zamenja samo, če je že izpolnjena. Če animacija zapusti to stanje, preden obvestilo o dokončanju, uvrščeno v čakalno vrsto, izpolni obljubo, lahko ista obljuba ostane v čakanju. Za naslednje predvajanje lastnost preberi znova. Če animacija ni v stanju idle, cancel() zavrne njeno trenutno obljubo finished z izjemo DOMException z imenom AbortError, če je obljuba še v čakanju. To zavrnitev lahko prestrežeš z try/catch. Če je animacija že v stanju idle, obljuba finished, ki je še v čakanju, tudi po klicu cancel() ostane v čakanju. Izvajanje lahko zato ostane ustavljeno pri await, ne da bi se izvedel blok catch. ready označuje pripravljenost predvajanja ali premora, ne pa dokončanja animacije.

To spada v Web Animations, ne v ECMAScript. Potrebna je podpora brskalnika; prisotnost Node 24 v repozitoriju tega ne potrjuje.

Primeri

(async () => {
  const element = document.createElement('div');
  element.textContent = 'Animation.finished';
  document.body.append(element);

  const animation = element.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'forwards' }
  );

  try {
    const completion = animation.finished;
    animation.finish();
    const result = await completion;
    console.log(result === animation);
    console.log(animation.playState);
  } catch (error) {
    console.log(error.name);
  } finally {
    animation.cancel();
    element.remove();
  }
})();

Rezultat

true
finished

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri