Non-standard This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.
The HTMLMediaElement.seekToNextFrame()
method asynchronously advances the the current play position to the next frame in the media.
This non-standard method is part of an experimentation process around support for non-real-time access to media for tasks including filtering, editing, and so forth. You should not use this method in production code, because its implementation may change—or be removed outright—without notice. You are, however, invited to experiment with it.
This method lets you access frames of video media without the media being performed in real time. This also lets you access media using frames as a seek unit rather than timecodes (albeit only by seeking one frame at a time until you get to the frame you want). Possible uses for this method include filtering and editing of video content.
This method returns immediately, returning a Promise
, whose fulfillment handler is called when the seek operation is complete. In addition, a seeked
event is sent to let interested parties know that a seek has taken place. If the seek fails because the media is already at the last frame, a seeked
event occurs, followed immediately by an ended
event.
If there is no video on the media element, or the media isn't seekable, nothing happens.
Syntax
var seekCompletePromise = HTMLMediaElement.seekToNextFrame(); HTMLMediaElement.seekToNextFrame();
Return value
A Promise
which is fulfilled once the seek operation has completed.
Firefox 49 returns undefined
instead of a promise, and performs the seek operation synchronously.
Specifications
Not part of any specification.
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
No support No |
Edge
No support No |
Firefox Full support 49 Full support 49 Disabled' From version 49: this feature is behind the |
IE
? |
Opera
? |
Safari
? |
WebView Android
No support No |
Chrome Android
? |
Firefox Android Full support 49 Full support 49 Disabled' From version 49: this feature is behind the |
Opera Android
? |
Safari iOS
? |
Samsung Internet Android
? |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- Deprecated. Not for use in new websites.'
- Deprecated. Not for use in new websites.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
HTMLMediaElement.seekToNextFrame() by Mozilla Contributors is licensed under CC-BY-SA 2.5.