CKTIS / JavaScript
Animation.finished — de promise voor het voltooien van de animatie
Met Animation.finished kun je met await wachten tot een animatie is voltooid, waarbij je rekening houdt met eventuele annulering.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const completedAnimation = await animation.finished;Animation.finished is een alleen-lezen eigenschap die een Promise<Animation> retourneert. Wanneer de animatie de status finished bereikt, ook via finish(), kan de promise worden vervuld met het animatieobject. Het is geen booleaanse waarde en ook geen methode.
Wanneer de animatie de status finished verlaat, wordt de huidige promise alleen vervangen als die al is vervuld. Verlaat de animatie die status voordat een in de wachtrij geplaatste voltooiingsmelding de promise vervult, dan kan dezelfde promise in afwachting blijven. Lees de eigenschap opnieuw voor een volgende afspeelbeurt. Als de animatie niet de status idle heeft, wijst cancel() de huidige finished-promise af met een DOMException met de naam AbortError, mits de promise nog in afwachting is. Gebruik try/catch om die afwijzing af te vangen. Heeft de animatie al de status idle, dan blijft een nog niet afgehandelde finished-promise ook na cancel() in afwachting. await kan dan blijven wachten zonder dat het catch-blok wordt uitgevoerd. ready geeft aan dat afspelen of pauzeren gereed is, niet dat de animatie is voltooid.
Dit hoort bij Web Animations, niet bij ECMAScript. Ondersteuning door de browser is vereist; de aanwezigheid van Node 24 in de repository toont die niet aan.
Voorbeelden
(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();
}
})();Resultaat
true finished
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.