MDN之Web API 接口参考(二)【XMLHttpRequest】

妖狐艹你老母 2021-06-26 16:06 450阅读 0赞

使用`XMLHttpRequest` (`XHR`)对象可以与服务器交互。您可以从`URL`获取数据，而无需让整个的页面刷新。这使得`Web`页面可以只更新页面的局部，而不影响用户的操作。`XMLHttpRequest`在 `Ajax` 编程中被大量使用。  
![在这里插入图片描述][20190714145308644.png]  
尽管名称如此，`XMLHttpRequest`可以用于获取任何类型的数据，而不仅仅是`XML`，它还支持 `HTTP`以外的协议(包括文件和`ftp`)。

如果您的通信需要从服务器接收事件或消息数据，请考虑通过`EventSource`接口使用 `server-sent events`。对于 `full-duplex` 通信， `WebSockets` 可能是更好的选择。

## 构造方法 ##

XMLHttpRequest()

构造函数初始化一个 `XMLHttpRequest` 对象。必须在所有其他方法被调用前调用构造函数。

## 属性 ##

此接口继承了 `XMLHttpRequestEventTarget`和 `EventTarget`的属性。

XMLHttpRequest.onreadystatechange

当`readyState`属性发生变化时调用的`EventHandler`。

XMLHttpRequest.readyState 只读

返回 一个`unsigned short` 即无符号短整型，请求的状态码。

XMLHttpRequest.response 只读

返回`ArrayBuffer`、`Blob`、`Document`、`DOMString`，具体是哪种类型取决于`XMLHttpRequest.responseType`的值。其中包含响应体`body`。

XMLHttpRequest.responseText XMLHttpRequest.responseText

返回一个`DOMString`，该`DOMString`包含对请求的响应，如果请求未成功或尚未发送，则返回`null`。

XMLHttpRequest.responseType

定义响应类型的枚举值。

XMLHttpRequest.responseURL 只读

返回响应的序列化`URL`，如果`URL`为空，则返回空字符串。

XMLHttpRequest.responseXML 只读

返回一个`Document`，其中包含该请求的响应，如果请求未成功、尚未发送或不能解析为`XML`或`HTML`，则返回`null`。

XMLHttpRequest.status 只读

返回 `unsigned short` 即无符号短整型请求响应状态。

XMLHttpRequest.statusText 只读

返回一个`DOMString`，其中包含`HTTP`服务器返回的响应状态。与 `XMLHTTPRequest.status`不同的是，它包括响应状态的整个文本(例如，“200 OK”)。

> 注意：根据`HTTP/2`规范(8.1.2.4响应伪标头字段)，`HTTP/2`没有定义一种方式来携带`HTTP/1.1`状态行中包含的版本或原因短语。

XMLHttpRequest.timeout

`unsigned long` 即无符号长整型，表示该请求的最大请求时间（毫秒），超过该时间请求会自动结束。

XMLHttpRequestEventTarget.ontimeout

当请求超时调用的`EventHandler`。

XMLHttpRequest.upload 只读

`XMLHttpRequestUpload`，表示上传过程。

XMLHttpRequest.withCredentials

`Boolean`，用来指定跨域的请求是否应该使用证书（如`cookie`或授权`header`头）。

## 非标准属性 ##

XMLHttpRequest.channel只读

`nsIChannel`，对象在执行请求时使用的通道。

XMLHttpRequest.mozAnon只读

一个布尔值，如果为真，请求将在没有`cookie`和身份验证`header`头的情况下发送。

XMLHttpRequest.mozSystem只读

一个布尔值，如果为真，则在请求时不会强制执行同源策略。

XMLHttpRequest.mozBackgroundRequest

一个布尔值，它指示对象是否是后台服务器端的请求

XMLHttpRequest.mozResponseArrayBuffer 已废弃 Gecko 6 只读

一个`ArrayBuffer`类型，把请求的响应作为一个`TypedArrays`。

XMLHttpRequest.multipart已废弃 Gecko 22

这个`Gecko`的独有属性，是一个布尔值，在`Firefox/Gecko 22`中被删除了。请使用`Server-Sent Events, Web Sockets`, 或来自进度事件的`responseText`代替。

## 方法 ##

XMLHttpRequest.abort()

如果请求已经被发送,则立刻中止请求.

XMLHttpRequest.getAllResponseHeaders()

以字符串的形式返回所有用`CRLF`分隔的响应头，如果没有收到响应，则返回`null`。

XMLHttpRequest.getResponseHeader()

返回包含指定响应头的字符串，如果响应尚未收到或响应中不存在该报头，则返回`null`。

XMLHttpRequest.open()

初始化一个请求。该方法只能`JavaScript`代码中使用，若要在`native code`中初始化请求，请使用`openRequest()`。

XMLHttpRequest.overrideMimeType()

重写由服务器返回的`MIME type`。

XMLHttpRequest.send()

发送请求。如果请求是异步的（默认），那么该方法将在请求发送后立即返回。

XMLHttpRequest.setRequestHeader()

设置`HTTP`请求头的值。您必须在`open()`之后、`send()`之前调用`setRequestHeader()`这个方法。

## 非标准方法 ##

init()

在 C++代码中初始化一个`XHR`对象.

> 警告: 该方法不能在 `JavaScript` 代码中使用.

openRequest()

初始化一个请求. 这个方法用于本地代码; 如果用`JavaScript` 代码来初始化请求, 使用 `open()`代替. 看文档`open()`.

XMLHttpRequest.sendAsBinary()

`send()`方法的变体，用来发送二进制数据。

[20190714145308644.png]: /images/20210626/41ada880322447ffb9cba037b1d5e442.png

发表评论取消回复

表情：

评论列表（有 0 条评论，450人围观）

还没有评论，来说两句吧...

相关阅读

相关 MDN之Web开发技术【display】

为显示`CSS`属性设置是否将元素视为块或内联元素以及用于其子元素的布局，例如`grid`或`flex`。 `display` CSS 属性指定了元素的显示类型，它包含两类基

旧城等待，/ 2021年07月04日 16:37/ 0 赞/ 499 阅读

相关 MDN之Web 开发技术【CSS 参考】

使用此CSS 参考页面以浏览按字母索引的所有标准 CSS 属性、伪类、伪元素、数据类型、以及@ 规则。你也可以浏览按类型排列的 CSS 选择器列表和 CSS 关键概念

悠悠/ 2021年07月04日 11:40/ 0 赞/ 504 阅读

相关 MDN之Web指南【内容分类】

每一个`HTML`元素都必须遵循定义了它可以包含哪一类内容的规则。这些规则被归类为几个常见的元素内容模型（`content model`）。每个`HTML`元素都属于0个、1

小咪咪/ 2021年06月26日 16:06/ 0 赞/ 626 阅读

相关 MDN之Web API 接口参考(五)【MediaSource】

> 这是一个实验中的功能 > 此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的

Love The Way You Lie/ 2021年06月26日 16:06/ 0 赞/ 550 阅读

相关 MDN之Web API 接口参考(二)【XMLHttpRequest】

使用`XMLHttpRequest` (`XHR`)对象可以与服务器交互。您可以从`URL`获取数据，而无需让整个的页面刷新。这使得`Web`页面可以只更新页面的局部，而不影响

妖狐艹你老母/ 2021年06月26日 16:06/ 0 赞/ 451 阅读

相关 MDN之Web API 接口参考(六)【使用服务器发送事件】

开发一个使用服务器发送的事件的`Web`应用程序是很容易的。你需要在服务器上的一些代码将事件流传输到`Web`应用程序，但`Web`应用程序端的事情几乎完全相同，处理任何其他类

太过爱你忘了你带给我的痛/ 2021年06月26日 16:06/ 0 赞/ 381 阅读

相关 MDN之Web API 接口参考(四)【Blob】

`Blob` 对象表示一个不可变、原始数据的类文件对象。`Blob` 表示的不一定是`JavaScript`原生格式的数据。`File` 接口基于`Blob`，继承了 `blo

布满荆棘的人生/ 2021年06月26日 16:06/ 0 赞/ 396 阅读

相关 MDN之Web API 接口参考(六)【 HTMLCanvasElement.toBlob()】

`HTMLCanvasElement.toBlob()` 方法创造`Blob`对象，用以展示`canvas`上的图片；这个图片文件可以被缓存或保存到本地，由用户代理端自行决定。

深碍√TFBOYSˉ_/ 2021年06月26日 16:06/ 0 赞/ 512 阅读

相关 MDN之Web API 接口参考(三)【FileReader】

`FileReader` 对象允许`Web`应用程序异步读取存储在用户计算机上的文件（或原始数据缓冲区）的内容，使用 `File` 或 `Blob` 对象指定要读取的文件或数据

短命女/ 2021年06月26日 16:06/ 0 赞/ 467 阅读

相关 MDN之Web API 接口参考(一)【Element.scrollIntoView()和Element.scrollTop】

`Element.scrollIntoView()` 方法让当前的元素滚动到浏览器窗口的可视区域内。语法 element.scrollIntoView();

待我称王封你为后i/ 2021年06月26日 16:06/ 0 赞/ 553 阅读