Request: bytes() method
Baseline
2025
Newly available
Since January 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Note: This feature is available in Web Workers.
The bytes() method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array.
Syntax
js
bytes()
Parameters
None.
Return value
A promise that resolves with a Uint8Array.
Exceptions
TypeError-
Thrown for one of the following reasons:
- The request body is disturbed or locked.
- There was an error decoding the body content (for example, because the
Content-Encodingheader is incorrect).
RangeError-
Thrown if there is a problem creating the associated
ArrayBuffer(for example, if the data size is too large).
Examples
js
const myArray = new Uint8Array(10);
const request = new Request("/myEndpoint", {
method: "POST",
body: myArray,
});
request.bytes().then((buffer) => {
// do something with the buffer sent in the request
});
Specifications
| Specification |
|---|
| Fetch # dom-body-bytes |