The state read-only property of the BaseAudioContext interface returns the current state of the AudioContext.
The state read-only property of the BaseAudioContext interface returns the current state of the AudioContext.
A string. Possible values are:
suspended The audio context has been suspended (with the AudioContext.suspend() method.)
runningThe audio context is running normally.
closed The audio context has been closed (with the AudioContext.close() method.)
The following snippet is taken from our AudioContext states demo (see it running live.) The onstatechange handler is used to log the current state to the console every time it changes.
js
audioCtx.onstatechange = () => { console.log(audioCtx.state); };
In iOS Safari, when a user leaves the page (e.g. switches tabs, minimizes the browser, or turns off the screen) the audio context's state changes to "interrupted" and needs to be resumed. For example:
js
function play() { if (audioCtx.state === "interrupted") { audioCtx.resume().then(() => play()); return; } // rest of the play() function }
| Specification |
|---|
| Web Audio API # dom-baseaudiocontext-state |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
state |
41 | 14 | 40 | No | 28 | 9 | 41 | 41 | 40 | 28 | 9 | 4.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BaseAudioContext/state