blob: 1d9ce5a237c3e7e362aad3d7bb1f21831838403f (
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
|
---
title: XMLHttpRequest.responseXML
slug: Web/API/XMLHttpRequest/responseXML
tags:
- AJAX
- API
- Fetching XML
- Loading XML
- プロパティ
- 読み取り専用
- Reading XML
- リファレンス
- 変換
- XML
- XMLHttpRequest
- ダウンロード
- responseXML
- アップロード
browser-compat: api.XMLHttpRequest.responseXML
translation_of: Web/API/XMLHttpRequest/responseXML
---
{{APIRef('XMLHttpRequest')}}
**`XMLHttpRequest.responseXML`** は読み取り専用のプロパティで、リクエストによって受け取った HTML または XML を含む {{domxref("Document")}}、またはリクエストが成功しなかった場合、まだ送信されていない場合、データが XML または HTML として解釈できない場合は `null` を返します。
> **Note:** `responseXML` という名前はこのプロパティの歴史の遺物です。これは HTML および XML の両方で動作します。
ふつう、レスポンスは "`text/xml`" として解釈されます。 {{domxref("XMLHttpRequest.responseType", "responseType")}} が "`document`" に設定され、リクエストが非同期に行われた場合、レスポンスは代わりに "`text/html`" として解釈されます。他の型のデータでは、 [`data:` の URL](/ja/docs/Web/HTTP/Basics_of_HTTP/Data_URIs) の場合と同様、 `responseXML` は `null` になります。
サーバーが {{HTTPHeader("Content-Type")}} を "`text/xml`" とも "`application/xml`" とも指定しなかった場合、 {{domxref("XMLHttpRequest.overrideMimeType()")}} を使用して強制的に XML として解釈させることができます。
このプロパティはワーカーでは使用できません。
## 構文
```js
var data = XMLHttpRequest.responseXML;
```
### 値
{{domxref("XMLHttpRequest")}} を用いて受け取った XML または HTML を解釈した {{domxref("Document")}}、またはデータを受け取っていなかったり、データが XML/HTML でな買ったりした場合は `null`
### 例外
- `InvalidStateError` {{domxref("DOMException")}}
- : {{domxref("XMLHttpRequest.responseType", "responseType")}} が "`document`" でも空文字列でもない。
## 例
```js
var xhr = new XMLHttpRequest;
xhr.open('GET', '/server');
// responseType を指定する場合は、空文字列または "document" でなければならない
xhr.responseType = 'document';
// レスポンスを XML として解釈するよう強制する
xhr.overrideMimeType('text/xml');
xhr.onload = function () {
if (xhr.readyState === xhr.DONE && xhr.status === 200) {
console.log(xhr.response, xhr.responseXML);
}
};
xhr.send();
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- {{domxref("XMLHttpRequest")}}
- {{domxref("XMLHttpRequest.response")}}
- {{domxref("XMLHttpRequest.responseType")}}
- [XML の解釈とシリアライズ](/ja/docs/Web/Guide/Parsing_and_serializing_XML)
- XML を解釈して DOM ツリーに格納: {{domxref("DOMParser")}}
- DOM ツリーを XML にシリアライズ: {{domxref("XMLSerializer")}} (特に {{domxref("XMLSerializer.serializeToString", "serializeToString()")}} メソッド)
|
