The arrayBuffer()
method of the Response
interface takes a Response
stream and reads it to completion. It returns a promise that resolves with an ArrayBuffer
.
The arrayBuffer()
method of the Response
interface takes a Response
stream and reads it to completion. It returns a promise that resolves with an ArrayBuffer
.
js
arrayBuffer()
None.
A promise that resolves with an ArrayBuffer
.
In our fetch array buffer live, we have a Play button. When pressed, the getData()
function is run. Note that before playing full audio file will be downloaded. If you need to play ogg during downloading (stream it) - consider HTMLAudioElement
:
js
new Audio("music.ogg").play();
In getData()
we create a new request using the Request()
constructor, then use it to fetch an OGG music track. We also use AudioContext.createBufferSource
to create an audio buffer source. When the fetch is successful, we read an ArrayBuffer
out of the response using arrayBuffer()
, decode the audio data using AudioContext.decodeAudioData()
, set the decoded data as the audio buffer source's buffer (source.buffer
), then connect the source up to the AudioContext.destination
.
Once getData()
has finished running, we start the audio source playing with start(0)
, then disable the play button so it can't be clicked again when it is already playing (this would cause an error.)
js
function getData() { const audioCtx = new AudioContext(); return fetch("viper.ogg") .then((response) => { if (!response.ok) { throw new Error(`HTTP error, status = ${response.status}`); } return response.arrayBuffer(); }) .then((buffer) => audioCtx.decodeAudioData(buffer)) .then((decodedData) => { const source = new AudioBufferSourceNode(); source.buffer = decodedData; source.connect(audioCtx.destination); return source; }); } // wire up buttons to stop and play audio play.onclick = () => { getData().then((source) => { source.start(0); play.setAttribute("disabled", "disabled"); }); };
The Response()
constructor accepts File
s and Blob
s, so it may be used to read a File
into other formats.
js
function readFile(file) { return new Response(file).arrayBuffer(); }
html
<input type="file" onchange="readFile(this.files[0])" />
Specification |
---|
Fetch Standard # ref-for-dom-body-arraybuffer① |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
arrayBuffer |
42 | 14 | 39 | No | 29 | 10.1 | 42 | 42 | 39 | 29 | 10.3 | 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/Response/arrayBuffer