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

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-Encoding header is incorrect).

RangeError

Thrown if there is a problem creating the associated ArrayBuffer (for example, if the data size is too large).

Examples

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
});