aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/xmlhttprequest/response/index.html
blob: 71ecacaa8c9b7b94ce0effa508a6848fc9bbda95 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
---
title: XMLHttpRequest.response
slug: Web/API/XMLHttpRequest/response
tags:
  - AJAX
  - API
  - XHR
  - XMLHttpRequest
  - 加载数据
  - 参考
  - 只读
  - 响应
  - 属性
  - 服务器
  - 获取内容
  - 获取数据
  - 读取数据
translation_of: Web/API/XMLHttpRequest/response
---
<div>{{APIRef('XMLHttpRequest')}}</div>

<p><span class="seoSummary">{{domxref("XMLHttpRequest")}} <code><strong>response</strong></code> 属性返回响应的正文。返回的类型为 {{domxref("ArrayBuffer")}}{{domxref("Blob")}}{{domxref("Document")}} 、 JavaScript {{jsxref("Object")}}{{domxref("DOMString")}} 中的一个。 这取决于 {{domxref("XMLHttpRequest.responseType", "responseType")}} 属性。</span></p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">var <em>body</em> = <em>XMLHttpRequest</em>.response;
</pre>

<h3 id="取值">取值</h3>

<p>一个对象,其类型取决于 {{domxref("XMLHttpRequest.responseType", "responseType")}} 的值。你可以尝试设置 <code>responseType</code> 的值,以便通过特定的类型请求数据。 <code>responseType</code> 要在调用 {{domxref("XMLHttpRequest.open", "open()")}} 初始化请求之后调用,并且要在调用 {{domxref("XMLHttpRequest.send", "send()")}} 发送请求到服务器之前调用。</p>

<p>如果请求尚未完成或未成功,则取值是 <code>null</code> 。例外的,读取文本数据时如果将 <code>responseType</code> 的值设置成<code>"text"</code>或空字符串(<code>""</code>)且当请求状态还在是 <code>LOADING</code> {{domxref("XMLHttpRequest.readyState", "readyState")}} (3) 时,response 包含到目前为止该请求已经取得的内容。</p>

<p>响应的类型如下所示。</p>

<p>{{page("/zh-CN/docs/Web/API/XMLHttpRequestResponseType", "取值")}}</p>

<dl>
</dl>

<h2 id="例子">例子</h2>

<p>此例子提供了一个方法—— <code>load()</code> ,它可以从服务器加载和处理页面。它通过创建一个 {{domxref("XMLHttpRequest")}} 对象并为 {{event("readystatechange")}} 事件创建一个监听器。这样的话,当 <code>readyState</code> 变成 <code>DONE</code> (4) 时就会获取 <code>response</code> 并将其传递给 <code>load()</code> 中提供的回调函数。</p>

<p>返回的内容会被作为原始文本数据处理 (因为这里没有覆盖  {{domxref("XMLHttpRequest.responseType", "responseType")}} 的默认值)。</p>

<pre class="brush: js">var url = 'somePage.html'; //一个本地页面

function load(url, callback) {
  var xhr = new XMLHttpRequest();

  xhr.onreadystatechange = function() {
    if (xhr.readyState === 4) {
      callback(xhr.response);
    }
  }

  xhr.open('GET', url, true);
  xhr.send('');
}

</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
  <tr>
   <td>{{SpecName('XMLHttpRequest', '#the-response-attribute')}}</td>
   <td>{{Spec2('XMLHttpRequest')}}</td>
   <td>WHATWG living standard</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div class="hidden">此页面中的兼容性表是根据结构化数据生成的。如果你想为数据做出贡献,请查看 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 并向我们发起拉取请求。</div>

<p>{{Compat("api.XMLHttpRequest.response")}}</p>

<h2 id="了解更多">了解更多</h2>

<ul>
 <li><a href="/zh-CN/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">使用 XMLHttpRequest</a></li>
 <li>获取文本和 HTML/XML 数据:{{domxref("XMLHttpRequest.responseText")}}{{domxref("XMLHttpRequest.responseXML")}}</li>
</ul>