Back to Content

HTMLMediaElement: networkState property

files/en-us/web/api/htmlmediaelement/networkstate/index.md

latest1.5 KB
Original Source

{{APIRef("HTML DOM")}}

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

Value

An unsigned short. Possible values are:

ConstantValueDescription
NETWORK_EMPTY0There is no data yet. Also, readyState is HAVE_NOTHING.
NETWORK_IDLE1HTMLMediaElement is active and has selected a resource, but is not using the network.
NETWORK_LOADING2The browser is downloading HTMLMediaElement data.
NETWORK_NO_SOURCE3No 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

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("HTMLMediaElement")}}: Interface used to define the HTMLMediaElement.networkState property