Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Animation.finished — la promise di completamento dell’animazione

Animation.finished permette di attendere con await il completamento di un’animazione, tenendo conto di un’eventuale cancellazione.

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

Sintassi

const completedAnimation = await animation.finished;

Animation.finished è una proprietà di sola lettura che restituisce una Promise<Animation>. Quando l’animazione raggiunge lo stato finished, anche tramite finish(), la promise può risolversi con l’oggetto animazione. Non è né un valore booleano né un metodo.

Quando l’animazione esce dallo stato finished, la promise corrente viene sostituita solo se si è già risolta. Se l’animazione esce da quello stato prima che la notifica di completamento in coda risolva la promise, la stessa promise può rimanere in sospeso. Leggi di nuovo la proprietà per un’altra riproduzione. Se l’animazione non è nello stato idle, cancel() rifiuta la promise finished corrente con una DOMException chiamata AbortError, purché la promise sia ancora in sospeso. Usa try/catch per gestire il rifiuto. Se invece l’animazione è già nello stato idle, cancel() lascia in sospeso la promise finished che era già in attesa. L’esecuzione può quindi rimanere sospesa su await senza entrare nel blocco catch. ready indica che la riproduzione o la pausa è pronta, non che l’animazione è completata.

Questo fa parte di Web Animations, non di ECMAScript. È necessario il supporto del browser; la presenza di Node 24 nel repository non lo dimostra.

Esempi

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

Risultato

true
finished

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti