← Back to release summary

AudioContextOptions.sampleRate

Category

Multimedia

Type

New or changed feature

Status

Enabled by default (Chrome 74)

Intent stage

Evaluate readiness to ship

• Breaking change: No
• Enterprise impact: None
• Spec maturity: Incubation
• Web Platform Tests: No

WPT details: This cannot be tested using WPT because there is no exposed way to get at the resampled values.

Summary

Allows developers to set the "sampleRate" for an AudioContext at the time it is created. This allows developers to set an arbitrary sample rate for audio processing in Web Audio API.

Motivation

This allows developers to control the sample rate separatly from the hardware rate. Use this to reduce complexity (using a lower sample rate) or to make the sample rate consistent across devices by using a fixed rate and letting WebAudio resample appropriately for the hardware rate.

Standards & signals

• Specification: https://webaudio.github.io/web-audio-api/#dom-audiocontextoptions-samplerate
• Firefox: Shipped/Shipping
• Safari: No signal
• Web developers: Strongly positive — The bug entry has 67 stars as of 3/4/2019. It's the most popular request in Web Audio API.
• Tracking bug: https://bugs.chromium.org/p/chromium/issues/detail?id=432248

Ecosystem

• Web Platform Tests: https://wpt.fyi/results/?q=audiocontextoptions-samplerate
• Chrome Platform Showcase: https://chrome-platform-showcase.paulkinlan-ea.deno.net/features
• GenDN reference: https://gendn.paulkinlan-ea.deno.net/features
• chrome.dev demos search: https://www.google.com/search?q=site%3Achrome.dev+AudioContextOptions.sampleRate
• MDN Web Docs: https://developer.mozilla.org/en-US/search?q=AudioContextOptions.sampleRate
• Baseline status: https://webstatus.dev/?q=AudioContextOptions.sampleRate

Docs: https://webaudio.github.io/web-audio-api/#dom-audiocontextoptions-samplerate

View on chromestatus.com