Fix AudioBuffer constructor calls in Web Audio basic concepts

[alexzinnde]

Description

The two AudioBuffer examples on "Basic concepts behind Web Audio API" called the constructor with an AudioContext as the first argument:

const buffer = new AudioBuffer(context, { numberOfChannels: 2, length: 22050, sampleRate: 44100 });

That signature comes from an early draft of the spec. The current constructor takes only an options dictionary: new AudioBuffer(options). This PR removes the context argument from both examples.

Motivation

Anyone who copies the examples hits a problem right away:

• In TypeScript, the DOM types report Expected 1 arguments, but got 2.
• In a browser, the AudioContext gets read as the options dictionary. It has no length member, so the constructor throws a TypeError.

Additional details

• Spec: https://webaudio.github.io/web-audio-api/#dom-audiobuffer-audiobuffer
• MDN reference page, which already shows the correct signature: https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer/AudioBuffer

Related issues and pull requests

Follow-up to #36562, which removed deprecated AudioBuffer options elsewhere but didn't change this page.

[github-actions]

Preview URLs (1 page)

• /en-US/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API

(comment last updated: 2026-09-15 23:13:40)

[wbamberg]

Thanks for your PR!

I think it would be better to remove the context creation calls, as these code samples seem from the context to be just about creating the buffer. In a code sample for creating the buffer, creating the context looks odd.

When the example says:

If you use this call above, you will get a stereo buffer with two channels that, when played back on an AudioContext

...I read "this call" as referring to the code sample, which just creates the buffer, then using it in an audio context is a separate operation.

[alexzinnde]

Good point — done. Both samples now just create the buffer; the prose still mentions playing it back on an AudioContext, which reads fine as a separate step.

[wbamberg]

👍 thank you for the fix!