aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMasahiro FUJIMOTO <mfujimot@gmail.com>2022-01-29 13:52:15 +0900
committerMasahiro FUJIMOTO <mfujimot@gmail.com>2022-02-05 13:19:25 +0900
commit3f1472279dfa36baeaf223071b929a2335de3bf7 (patch)
tree631a826a3757d652732f7aede0c3eeb9d73986bf
parent5a40f94749c69b13772206c9a4f7b7ea030d1527 (diff)
downloadtranslated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.tar.gz
translated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.tar.bz2
translated-content-3f1472279dfa36baeaf223071b929a2335de3bf7.zip
20220121 時点の英語版に同期
-rw-r--r--files/ja/web/api/xmlhttprequest/statustext/index.md64
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)