Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Animation.cancel(): anulowanie animacji

Animation.cancel() przerywa animację i usuwa jej wpływ na element, zamiast zatrzymywać ją na bieżącej klatce.

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

Składnia

animation.cancel();

animation.cancel() to metoda Web Animations, nie samego ECMAScript. Nie przyjmuje argumentów i zwraca undefined. Ustawia playState na idle, a currentTime i startTime na null.

Usuwa wpływ animacji, również przy fill: 'both'; nie zapisuje klatki w stylach. Inaczej niż pause(), nie zachowuje bieżącej pozycji; inaczej niż finish(), nie przechodzi do końca. Obiekt można ponownie uruchomić przez play().

Jeśli animacja nie jest w stanie idle, metoda zastępuje dotychczasową obietnicę finished nową i kolejkuje zdarzenie cancel. Dotychczasowa obietnica zostaje odrzucona z błędem AbortError tylko wtedy, gdy nadal oczekuje na rozstrzygnięcie. Jeśli została już spełniona, pozostaje spełniona. Obsługę odrzucenia dołącz przed anulowaniem. Przykład wymaga przeglądarki; Node 24 nie potwierdza obsługi tego API.

Przykłady

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

Wynik

idle
true
true
AbortError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła