W3cubDocs

/Web APIs

HTMLMediaElement: networkState property

The HTMLMediaElement.networkState property indicates the current state of the fetching of media over the network.

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.

html

<audio id="example" preload="auto">
  <source src="sound.ogg" type="audio/ogg" />
</audio>

js

const obj = document.getElementById("example");

obj.addEventListener("playing", () => {
  if (obj.networkState === 2) {
    // Still loading…
  }
});

Specifications

Specification
HTML Standard
# dom-media-networkstate-dev

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
networkState 3 12
3.5The NETWORK_LOADED state was removed to align with the HTML spec in Firefox 4.
 9 ≤12.1 3.1 ≤37 18 4 ≤12.1 3 1.0

See also

  • HTMLMediaElement: Interface used to define the HTMLMediaElement.networkState property

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/networkState