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 (en-US)
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 (en-US) geradas pela animação e aborta esta execução.

Nota: Quando uma animação é cancelada, os valores de startTime (en-US) 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 (en-US) com a DOMException (en-US) nomeada AbortError.

Especificações

Specification
Web Animations
# dom-animation-cancel

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também