The HTMLMediaElement.readyState
property indicates the readiness state of the media.
Syntax
var readyState = audioOrVideo.readyState;
Value
An unsigned short
. Possible values are:
Constant | Value | Description |
---|---|---|
HAVE_NOTHING
|
0 | No information is available about the media resource. |
HAVE_METADATA
|
1 | Enough of the media resource has been retrieved that the metadata attributes are initialized. Seeking will no longer raise an exception. |
HAVE_CURRENT_DATA
|
2 | Data is available for the current playback position, but not enough to actually play more than one frame. |
HAVE_FUTURE_DATA
|
3 | Data for the current playback position as well as for at least a little bit of time into the future is available (in other words, at least two frames of video, for example). |
HAVE_ENOUGH_DATA
|
4 | Enough data is available—and the download rate is high enough—that the media can be played through to the end without interruption. |
Examples
This example will listen for audio data to be loaded for the element `example`. It will then check if at least the current playback position has been loaded. If it has, the audio will play.
<audio id="example" preload="auto">
<source src="sound.ogg" type="audio/ogg" />
</audio>
var obj = document.getElementById('example');
obj.addEventListener('loadeddata', function() {
if(obj.readyState >= 2) {
obj.play();
}
});
Specifications
Specification | Status | Comment |
HTML Living StandardThe definition of 'HTMLMediaElement.readyState' in that specification. | Living Standard | |
HTML5The definition of 'HTMLMediaElement.readyState' in that specification. | Recommendation |
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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
readyState
|
Chrome
Full support 43 |
Edge
Full support 12 |
Firefox
Full support 3.5 |
IE
Full support 9 |
Opera
Full support Yes |
Safari
Full support 6 |
WebView Android
Full support 43 |
Chrome Android
Full support 43 |
Firefox Android
Full support Yes |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support 4.0 |
Legend
- Full support
- Full support
See also
- The interface defining it,
HTMLMediaElement
.
HTMLMediaElement.readyState by Mozilla Contributors is licensed under CC-BY-SA 2.5.