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

BCD tables only load in the browser

See also

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