Request: text() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Note: This feature is available in Web Workers.

The text() method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8.

Syntax

text()

Parameters

None.

Return value

A Promise that resolves with a String.

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).

Examples

const text = "Hello world";

const request = new Request("/myEndpoint", {
  method: "POST",
  body: text,
});

request.text().then((text) => {
  // do something with the text sent in the request
});