Animation.cancel()
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
- Web Animations API (en-US)
KeyframeEffect
(en-US)Animation
Animation.playState
Animation.finished
(en-US) returns the promise this action will reject if the animation'splayState
is notidle
.