Animation.cancel()

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Experimental: Esta é uma tecnologia experimental
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

O método Animation.cancel() da interface Animation , limpa todas as keyframeEffects geradas pela animação e aborta esta execução.

Nota: Quando uma animação é cancelada, os valores de startTime e currentTime são definidos como null.

Sintaxe

js
// cancela animação
animation.cancel();

Parametros

Nenhum.

Valor de retorno

Nenhum.

Exceptions

Se o método Animation.playState da animação estiver executando quando a operação for cancelada, esta ação vai rejeitar a current finished promise com a DOMException nomeada AbortError.

Especificações

Specification
Web Animations
# dom-animation-cancel

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também