diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-01-29 13:52:15 +0900 |
---|---|---|
committer | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-05 13:19:25 +0900 |
commit | 3f1472279dfa36baeaf223071b929a2335de3bf7 (patch) | |
tree | 631a826a3757d652732f7aede0c3eeb9d73986bf | |
parent | 5a40f94749c69b13772206c9a4f7b7ea030d1527 (diff) | |
download | translated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.tar.gz translated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.tar.bz2 translated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.zip |
20220121 時点の英語版に同期
-rw-r--r-- | files/ja/web/api/xmlhttprequest/statustext/index.md | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/files/ja/web/api/xmlhttprequest/statustext/index.md b/files/ja/web/api/xmlhttprequest/statustext/index.md new file mode 100644 index 0000000000..5066bb7eaf --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/statustext/index.md @@ -0,0 +1,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) |