Animation.finish()

Experimental: Esta es una tecnolog铆a experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producci贸n.

El m茅todo finish() de la interfaz Animation de la Web Animations API  establece el tiempo de reproducci贸n actual hasta el final de la animaci贸n correspondiente a la direcci贸n de reproducci贸n actual. Es decir, si la animaci贸n se est谩 reproduciendo hacia adelante, establece el tiempo de reproducci贸n a la longitud de la secuencia de animaci贸n, y si la animaci贸n se reproduce hacia atras , (habiendo llamado a su m茅todo reverse()), establece el tiempo de la reproducci贸n en 0.

Sintaxis

Animation.finish(); 

Par谩metros

None.

Valor devuelto

None.

Excepciones

InvalidState
La velocidad de reproducci贸n del reproductor es 0 o la velocidad de reproducci贸n de la animaci贸n es mayor que 0 y el tiempo de finalizaci贸n de la animaci贸n es infinito.

Ejemplos

El siguiente ejemplo muestra c贸mo usar el m茅todo finish() y captura un error InvalidState.

interfaceElement.addEventListener("mousedown", function() {
  try {
    player.finish();
  } catch(e if e instanceof InvalidState) {
    console.log("finish() called on paused or finished animation.");
  } catch(e);
    logMyErrors(e); //pasa el objeto excepci贸n al manejador de errores.
  }
});

El siguiente ejemplo finaliza todas las animaciones en un solo elemento, independientemente de su direcci贸n de reproducci贸n.

elem.getAnimations().forEach(
  function(animation){
    return animation.finish();
  }
);

Especificaciones

Specification Status Comment
Web Animations
La definici贸n de 'finish()' en esta especificaci贸n.
Working Draft  

Compatibilidad del navegador

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 39.0 48 (48)[1] Sin soporte Sin soporte Sin soporte
Feature Android Android Webview Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support Sin soporte 39.0 48.0 (48)[1] Sin soporte Sin soporte Sin soporte 39.0

[1] La Web Animations API solo est谩 habilitada por defecto en Firefox Developer Edition y Nightly builds. Puedes habilitarlo en versiones Beta y de lanzamiento estableciendo la preferencia dom.animations-api.core.enabled en true, y puedes deshabilitarlo en cualquier versi贸n de Firefox estableciendo esta propiedad en false.

Ver tambi茅n