HTMLMediaElement.networkState

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  
HTML5
The definition of 'HTMLMediaElement.networkState' in that specification.
Recommendation  

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support YesEdge Full support YesFirefox Full support 3.5
Notes
Full support 3.5
Notes
Notes The NETWORK_LOADED state was removed to align with the HTML spec in Firefox 4.
IE Full support 9Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

See also

Document Tags and Contributors

Last updated by: sideshowbarker,