Animation.cancel()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
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
// 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
- Web Animations API
KeyframeEffect
Animation
Animation.playState
Animation.finished
returns the promise this action will reject if the animation'splayState
is notidle
.