使用 fetch() 发起请求后，调用返回 promise 的 .text() 方法即可将响应体解析为纯文本字符串。该方法会自动处理 http 状态码，若请求成功则返回包含完整文本内容的 promise，开发者只需在 then 回调中接收该字符串或配合 async/await 直接获取。
fetch() 返回的 Response 对象有哪些关键属性
Response 对象是 fetch() 的直接返回值，它包含了响应的元数据，如 status（HTTP 状态码）、ok（布尔值表示是否成功）和 headers（响应头集合）。这些属性允许你在解析正文前检查请求是否成功，例如通过判断 response.ok 来决定是否需要抛出异常或进行错误处理。
const url = 'https://api.example.com/data';
fetch(url)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(text => {
console.log('Raw text:', text);
console.log('Type:', typeof text);
})
.catch(error => {
console.error('Fetch failed:', error);
});
上述代码展示了标准的错误处理流程。首先检查 response.ok，如果为 false 则抛出错误；否则调用 response.text()。最终在第二个 then 中打印出解析后的文本及其类型，确保得到的是字符串而非其他对象。
如何处理接口返回的 JSON 格式文本数据
虽然 .text() 可以获取原始文本，但大多数 API 返回的是 JSON 格式。此时应使用 .json() 方法，它会在内部自动调用 JSON.parse() 将文本转换为 JavaScript 对象。如果接口确实只返回纯文本且无需解析，继续使用 .text() 更为合适，避免不必要的解析开销。
const jsonUrl = 'https://api.example.com/json-data';
async function fetchData() {
try {
const response = await fetch(jsonUrl);
if (!response.ok) {
throw new Error(`Status: ${response.status}`);
}
// 假设接口返回 JSON
const data = await response.json();
console.log('Parsed object:', data);
// 如果必须获取原始文本
const rawText = await response.text();
console.log('Raw text from same response:', rawText);
} catch (error) {
console.error('Error:', error);
}
}
在 async/await 模式下，代码结构更清晰。注意 response.json() 和 response.text() 只能被调用一次，因为响应流是一次性的。如果先调用了 .json()，再尝试调用 .text() 会失败，反之亦然。因此需根据实际需求选择合适的方法。
当接口返回空响应体时 .text() 会返回什么
如果服务器返回的响应体为空（例如 HTTP 204 No Content），.text() 方法会返回一个空字符串 ""，而不会抛出错误或返回 null。这是符合规范的预期行为，开发者可以直接对返回的空字符串进行长度检查或后续处理，无需额外判断是否为空值。
const emptyUrl = 'https://api.example.com/empty';
fetch(emptyUrl)
.then(response => response.text())
.then(text => {
console.log('Empty response text:', text);
console.log('Length:', text.length); // 输出 0
console.log('Is empty string:', text === ''); // 输出 true
});
此示例验证了空响应体的处理方式。即使没有内容，.text() 仍会成功解析并返回空字符串。这确保了代码在面对不同响应情况时的健壮性，避免因意外 null 或异常导致程序崩溃。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
