使用 fetch() 发起请求后,通过链式调用其返回的 response 对象上的方法(如 .json()、.text())即可将原始响应体转换为 javascript 数据。具体做法是在 fetch 调用后直接挂载转换方法,该方法会解析响应流并返回一个包含最终数据的 promise,从而完成从网络字节到业务对象的转换。

fetch() 返回的 Response 对象包含哪些转换方法
fetch() 函数本身只负责建立连接并返回一个 Response 实例,此时响应体尚未被读取或解析。要获取实际内容,必须调用该实例提供的特定转换方法。这些方法包括 .json() 用于解析 JSON 格式数据,.text() 用于获取纯文本字符串,以及 .blob() 和 .arrayBuffer() 用于处理二进制数据。每种方法都会消耗响应流,因此同一个 Response 对象只能被转换一次。

const url = 'https://api.example.com/data';
fetch(url)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.json();
})
.then(data => {
console.log('Parsed Data:', data);
})
.catch(error => {
console.error('Fetch failed:', error);
});上述代码展示了标准的转换流程。首先检查 response.ok 确保状态码在 200-299 之间,然后调用 response.json()。如果服务器返回的是有效的 JSON 字符串,data 变量将是一个解析后的 JavaScript 对象;如果返回的是 HTML 或其他文本,则应改用 response.text()。若响应体损坏或非预期格式,.json() 会抛出异常,由 .catch() 捕获。
立即学习“Java免费学习笔记(深入)”;
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。
如何处理非 JSON 格式的接口响应
当接口返回的数据不是 JSON 格式时,例如 XML、CSV 或纯文本,需要使用不同的转换方法。对于 XML 内容,通常先通过 .text() 获取字符串,再结合 DOMParser 进行解析;对于 CSV 或简单文本,直接使用 .text() 即可得到完整字符串。此外,如果接口返回的是文件流(如图片),则应使用 .blob() 将其转换为 Blob 对象,以便后续生成 URL 或上传。

// 处理 XML 响应示例
fetch('/api/report.xml')
.then(response => response.text())
.then(xmlString => {
const parser = new DOMParser();
const xmlDoc = parser.parseFromString(xmlString, 'text/xml');
console.log(xmlDoc.getElementsByTagName('title')[0].textContent);
});
// 处理 CSV 响应示例
fetch('/api/export.csv')
.then(response => response.text())
.then(csvText => {
const rows = csvText.split('\n').map(row => row.split(','));
console.log(rows);
});在处理非 JSON 数据时,关键在于选择正确的中间转换步骤。.text() 是通用的入口,它将任何类型的响应体都转化为字符串,之后开发者可以根据字符串内容自行决定如何进一步处理。这种方式虽然不如 .json() 那样一步到位,但提供了最大的灵活性,适用于各种自定义或标准文本协议。
基于 response.json() 解析失败的具体问题
当调用 response.json() 时,如果服务器返回的内容不符合 JSON 语法规范,或者响应体为空,该方法会抛出 TypeError 或 SyntaxError。这种情况常见于服务端发生未捕获异常导致返回了 HTML 错误页面,而非预期的 JSON 数据。此时,直接调用 .json() 会导致 Promise 拒绝,程序进入 .catch() 分支。为了避免这种隐式崩溃,可以在转换前检查 Content-Type 头,或者使用 try-catch 包裹解析逻辑,确保即使解析失败也能提供友好的错误提示。

















