The HTMLMediaElement.networkState
property indicates the current state of the fetching of media over the network.
Syntax
var networkState = audioOrVideo.networkState;
Value
An unsigned short
. Possible values are:
Constant | Value | Description |
---|---|---|
NETWORK_EMPTY |
0 | There is no data yet. Also, readyState is HAVE_NOTHING . |
NETWORK_IDLE |
1 | HTMLMediaElement is active and has selected a resource, but is not using the network. |
NETWORK_LOADING |
2 | The browser is downloading HTMLMediaElement data. |
NETWORK_NO_SOURCE |
3 | No HTMLMediaElement src found. |
Examples
This example will listen for the audio element to begin playing and then check if it is still loading data.
<audio id="example" preload="auto"> <source src="sound.ogg" type="audio/ogg" /> </audio>
var obj = document.getElementById('example'); obj.addEventListener('playing', function() { if (obj.networkState === 2) { // Still loading... } });
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'HTMLMediaElement.networkState' in that specification. |
Living Standard | No change from HTML5 |
HTML5 The definition of 'HTMLMediaElement.networkState' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 3.5 (1.9.1) [1] | 9 | ? | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | ? | (Yes) | (Yes) |
[1] The NETWORK_LOADED
state was removed to align with the HTML spec in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1).
See also
- The interface defining it,
HTMLMediaElement
.