Skip to content

Response:text() 方法 ​

text() 方法读出全部响应内容,按 UTF-8 解码成字符串。

语法 ​

text()

参数 ​

无。

返回值 ​

Promise。内容全部下载完之后完成,得到字符串。

  • 一律按 UTF-8 解码,不看响应头里声明的编码。其它编码的文本用 arrayBuffer() 读出字节,自己解码。
  • 内容不是合法的 UTF-8 时得到空串 '',不报错。
  • 没有内容的响应得到空串。

异常 ​

返回的 Promise 在这些情况下被拒绝:

TypeError

  • 内容已经读过:Body has already been read。
  • body 上有读取器:Body is locked: response.body has a reader。
  • 下载中途网络中断:message 以 Network request failed: 开头。

name 是 'AbortError' 的 Error

下载中途请求被取消,或者 AbortSignal.timeout() 到了时间。

说明 ​

解码在后台进行,解码大文本时不会卡住界面。内容在下载的那一份之外再生成一份字符串。

示例 ​

js
async function main() {
  const res = await fetch('https://httpbin.org/range/16');
  const text = await res.text();
  console.log(text);
}
main();

结果:输出 abcdefghijklmnop。

和 Web 的差别 ​

Web 按响应声明的编码解码,不合法的字节换成替换字符。Nacre 一律按 UTF-8 解码,不合法时得到空串。

参见 ​