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.
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 # dom-media-networkstate-dev |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
networkState
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.
See also
HTMLMediaElement: Interface used to define theHTMLMediaElement.networkStateproperty