Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Animation.finished — obietnica zakończenia animacji

Animation.finished pozwala oczekiwać na zakończenie animacji przez await, z obsługą anulowania.

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

const completedAnimation = await animation.finished;

Animation.finished to właściwość tylko do odczytu zwracająca Promise<Animation>. Po osiągnięciu stanu finished, również wskutek finish(), obietnica może zostać spełniona obiektem animacji. Nie jest wartością logiczną ani metodą.

Po opuszczeniu stanu finished właściwość zwraca nową obietnicę tylko wtedy, gdy bieżąca obietnica została już spełniona. Jeśli animacja opuści ten stan, zanim zaplanowane powiadomienie o zakończeniu spełni obietnicę, ta sama obietnica może pozostać w stanie oczekiwania. Przy kolejnym odtwarzaniu odczytaj właściwość ponownie. Jeśli animacja nie jest w stanie idle, cancel() odrzuca jej bieżącą obietnicę finished, o ile ta nadal oczekuje, zgłaszając DOMException o nazwie AbortError. To odrzucenie możesz obsłużyć za pomocą try/catch. Jeśli animacja jest już w stanie idle, wywołanie cancel() nie odrzuca oczekującej obietnicy finished: await może nadal czekać, nie przechodząc do bloku catch. ready oznacza gotowość operacji odtwarzania lub pauzy, nie zakończenie animacji.

To interfejs Web Animations, nie ECMAScript. Wymaga obsługi w przeglądarce; sama obecność Node 24 w repozytorium jej nie potwierdza.

Przykłady

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

Wynik

true
finished

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

Źródła