blob: 5066bb7eaf4ba197d5ec4b9852652fad11f58854 (
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
|
---
title: XMLHttpRequest.statusText
slug: Web/API/XMLHttpRequest/statusText
tags:
- AJAX
- API
- プロパティ
- 読み取り専用
- リファレンス
- XMLHttpRequest
- XMLHttpRequest Status
browser-compat: api.XMLHttpRequest.statusText
translation_of: Web/API/XMLHttpRequest/statusText
---
{{APIRef('XMLHttpRequest')}}
**`XMLHttpRequest.statusText`** は読み取り専用のプロパティで、 [`DOMString`](/ja/docs/Web/API/DOMString) で HTTP サーバーから返されるステータスメッセージを示します。 [`XMLHTTPRequest.status`](/ja/docs/Web/API/XMLHTTPRequest/status) が数値のステータスコードを示すのとは異なり、このプロパティはレスポンスステータスの*テキスト*を、 "OK" や "Not Found" のように示します。リクエストの [`readyState`](/ja/docs/Web/API/XMLHttpRequest/readyState) が `UNSENT` または `OPENED` の状態であった場合、 `statusText` の値は空文字列になります。
サーバーが明示的にステータスのテキストを指定しなかった場合、 `statusText` は既定値 "OK" と見なされます。
> **Note:** HTTP/2 コネクションのレスポンスでは、常に空文字列になります。これは HTTP/2 がステータステキストに対応していないからです。
## 例
```js
var xhr = new XMLHttpRequest();
console.log('0 UNSENT', xhr.statusText);
xhr.open('GET', '/server', true);
console.log('1 OPENED', xhr.statusText);
xhr.onprogress = function () {
console.log('3 LOADING', xhr.statusText);
};
xhr.onload = function () {
console.log('4 DONE', xhr.statusText);
};
xhr.send(null);
/**
* 以下のように出力されます。
*
* 0 UNSENT
* 1 OPENED
* 3 LOADING OK
* 4 DONE OK
*/
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- [HTTP レスポンスコード](/ja/docs/Web/HTTP/Response_codes)の一覧
- [HTTP](/ja/docs/Web/HTTP)
- [WHATWG Fetch Living Standard](https://fetch.spec.whatwg.org/#concept-response-status-message)
|
