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
js
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-Encodingheader is incorrect).
Examples
js
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
});
Specifications
| Specification |
|---|
| Fetch # ref-for-dom-body-text① |
Browser compatibility
| desktop | mobile | server | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
text
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support