KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Animation.cancel(): een animatie annuleren

Animation.cancel() breekt een animatie af en verwijdert het effect ervan op het element, in plaats van de animatie op het huidige frame vast te zetten.

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

animation.cancel();

animation.cancel() is een methode van Web Animations, niet van ECMAScript zelf. De methode neemt geen argumenten en retourneert undefined. Ze stelt playState in op idle en currentTime en startTime op null.

De methode verwijdert het effect van de animatie, ook bij fill: 'both'; er wordt geen frame in de stijlen opgeslagen. Anders dan pause() behoudt ze de huidige positie niet; anders dan finish() gaat ze niet naar het einde. Je kunt het object opnieuw starten met play().

Als de animatie niet de status idle heeft, vervangt de methode de bestaande finished-promise door een nieuwe en zet ze een cancel-event in de wachtrij. De oude promise wordt alleen met AbortError afgewezen als die nog in afwachting is. Als de promise al is vervuld, blijft die vervuld. Voeg de afhandeling van de afwijzing toe voordat je annuleert. Het voorbeeld vereist een browser; Node 24 toont niet aan dat deze API wordt ondersteund.

Voorbeelden

(async () => {
  const box = document.createElement('div');
  document.body.append(box);
  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  const outcome = animation.finished.catch(error => error.name);
  animation.cancel();
  console.log(animation.playState);
  console.log(animation.currentTime === null);
  console.log(animation.startTime === null);
  console.log(await outcome);
  box.remove();
})();

Resultaat

idle
true
true
AbortError

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.

Bronnen