CKTIS / JavaScript
Animation.finished — promise dovršetka animacije
Animation.finished omogućuje da uz await čekaš dovršetak animacije, uz uvažavanje mogućeg otkazivanja.
Verzija: 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 svojstvo je samo za čitanje koje vraća Promise<Animation>. Kada animacija dosegne stanje finished, pa i pozivom finish(), promise se može ispuniti objektom animacije. Nije ni Booleova vrijednost ni metoda.
Kad animacija izađe iz stanja finished, trenutačna se promise zamjenjuje samo ako je već ispunjena. Ako animacija izađe iz tog stanja prije nego što obavijest o dovršetku stavljena u red čekanja ispuni promise, ista promise može ostati na čekanju. Za sljedeću reprodukciju ponovno pročitaj svojstvo. Ako animacija nije u stanju idle, cancel() odbacuje njezinu trenutačnu promise finished iznimkom DOMException naziva AbortError pod uvjetom da je promise još na čekanju. To odbacivanje možeš obraditi pomoću try/catch. Ako je animacija već u stanju idle, promise finished koja je na čekanju ostaje na čekanju i nakon poziva cancel(). Izvršavanje tako može ostati zaustavljeno na await bez ulaska u blok catch. ready označava spremnost reprodukcije ili pauze, a ne dovršetak animacije.
Ovo pripada Web Animations, a ne ECMAScriptu. Potrebna je podrška preglednika; prisutnost Nodea 24 u repozitoriju ne potvrđuje je.
Primjeri
(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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.