Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

AudioContext.state

This article needs a technical review. How you can help.

The state read-only property of the AudioContext interface returns the current state of the AudioContext.

Syntax

var audioCtx = new AudioContext();
var myState = audioCtx.state;

Value

A DOMString. Possible values are:

  • suspended: The audio context has been suspended (with the AudioContext.suspend() method.)
  • running: The audio context is running normally.
  • closed: The audio context has been closed (with the AudioContext.close() method.)

Example

The following snippet is taken from our AudioContext states demo (see it running live.) The AudioContext.onstatechange hander is used to log the current state to the console every time it changes.

audioCtx.onstatechange = function() {
  console.log(audioCtx.state);
}

Specifications

Specification Status Comment
Web Audio API
The definition of 'state' in that specification.
Working Draft  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 43.0 40.0 (40.0)  Not supported ? ?
Feature Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? ? ? ? ? ? ?

See also

Document Tags and Contributors

 Contributors to this page: ayqy, chrisdavidmills
 Last updated by: ayqy,