Animation.finish()

Syntax

animation.finish(); 

Parameters

None.

Return Value

None.

Exceptions

An InvalidState error is raised if the player's playback rate is 0 or the animation's playback rate is greater than 0 and the end time of the animation is infinity.

Examples

The following example shows how to use the finish() method and catch an InvalidState error.

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); //pass exception object to error handler
  }
});

The following example finishes all the animations on a single element, regardless of their direction of playback.

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

Specifications

Browser compatibility

See also

• Web Animations API
• Animation for other methods and properties you can use to control web page animation.
• Animation.play() to play an animation forward.
• Animation.reverse() to play an animation backward.