HTMLMediaElement: networkState property

Baseline

Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

See full compatibility
Learn more

The networkState read-only property of the HTMLMediaElement interface 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>

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

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