MDN self-hosted library · e01.org

HTMLMediaElement: networkState property

HTML DOM

Open notebook · 2 cells web-api-instance-property upstream source

HTML DOM

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.

<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…
  }
});

Specifications

Browser compatibility

See also

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