Request: json() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年3月以降、すべてのブラウザーで利用可能です。
メモ: この機能はウェブワーカー内で利用可能です。
json() は Request インターフェイスのメソッドで、
このメソッドはリクエスト本体を読み込み、本文を解釈した結果を JSON として解決したプロミスとして返します。
このメソッドは json() という名前ですが、結果は JSON ではなく、JSON を入力として受け取り、それを解釈して JavaScript オブジェクトを生成した結果であることに注意してください。
構文
js
json()
引数
なし。
返値
JavaScript のオブジェクトに解決する Promise です。このオブジェクトは、オブジェクト、配列、文字列、数値など、JSON で表せるものであれば何でもかまいません。
例外
TypeError-
以下のどちらかの理由で発生します。
- リクエストの本文が変更中またはロック済みである。
- 本文のコンテンツをデコードする際にエラーが発生した（例えば、
Content-Encodingヘッダーが正しくないなど）。
SyntaxError-
このリクエスト本文は JSON として解釈できません。
例
js
const obj = { hello: "world" };
const request = new Request("/myEndpoint", {
method: "POST",
body: JSON.stringify(obj),
});
request.json().then((data) => {
// リクエストで送信されたデータに対して何らかの処理をする
});
仕様書
| 仕様書 |
|---|
| Fetch # ref-for-dom-body-json① |