XMLHttpRequest:responseText 属性
注意:此功能在Web Workers中可用,但Service Workers除外。
只读的XMLHttpRequest
属性responseText
返回在发送请求后从服务器接收到的文本。
值
一个字符串,其中包含使用XMLHttpRequest
接收到的文本数据,或者如果请求失败或尚未收到任何内容则为""
。
在处理异步请求时,responseText
的值始终包含从服务器接收到的当前内容,即使它不完整,因为数据尚未完全接收。
当readyState
的值变为XMLHttpRequest.DONE
(4
)且status
变为 200("OK"
)时,您就知道整个内容已接收。
异常
InvalidStateError
DOMException
-
如果
XMLHttpRequest.responseType
未设置为空字符串或"text"
,则会抛出此异常。由于responseText
属性仅对文本内容有效,因此任何其他值都是错误条件。
示例
js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);
// If specified, responseType must be empty string or "text"
xhr.responseType = "text";
xhr.onload = () => {
if (xhr.readyState === xhr.DONE) {
if (xhr.status === 200) {
console.log(xhr.response);
console.log(xhr.responseText);
}
}
};
xhr.send(null);
规范
规范 |
---|
XMLHttpRequest 标准 # the-responsetext-attribute |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。