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.