Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Animation.cancel(): zrušení animace

Animation.cancel() přeruší animaci a odstraní její účinek na prvek, místo aby ji zastavila na aktuálním snímku.

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

Syntaxe

animation.cancel();

animation.cancel() je metoda Web Animations, nikoli samotného ECMAScriptu. Nepřijímá žádné argumenty a vrací undefined. Nastaví playState na idle a currentTime i startTime na null.

Odstraní účinek animace, a to i při fill: 'both'; snímek neuloží do stylů. Na rozdíl od pause() nezachová aktuální pozici; na rozdíl od finish() nepřejde na konec. Objekt lze znovu spustit pomocí play().

Pokud animace není ve stavu idle, metoda nahradí dosavadní promise finished novou a zařadí událost cancel do fronty. Dosavadní promise je odmítnuta s chybou AbortError, jen pokud dosud nebyla vyřízena. Pokud už byla splněna, zůstane splněná. Ošetření odmítnutí přidejte před zrušením. Příklad vyžaduje prohlížeč; Node 24 nepotvrzuje podporu tohoto API.

Příklady

(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();
})();

Výsledek

idle
true
true
AbortError

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje