Request.mode

Request インターフェースの mode 読み取り専用プロパティは、リクエストのモード（たとえば、cors、no-cors、cors-with-forced-preflight、same-origin）を含みます。これは、クロスオリジンリクエストに対して有効なレスポンスができるか、またレスポンスのプロパティが読み取り可能かどうかを判定するために使用されます：

• same-origin — このモードを設定してほかのオリジンにリクエストをした場合、結果は単純にエラーになります。リクエストが常に同一オリジンに行われることを保証するために使用できます。
• no-cors — HEAD か GET、POST 以外のメソッドを防ぎます。任意の ServiceWorkers がこれらをインターセプトする場合、これらを除いてヘッダーを追加したりオーバーライドしたりできなくなります。加えて、JavaScript は解決された Response のプロパティにはアクセスできません。これは、ServiceWorkers が Web のセマンティクスに影響を与えず、ドメインを跨いでデータが流出するセキュリティやプライバシーの問題が発生することを防ぎます。
• cors — クロスオリジンリクエストを許可します。たとえば、サードパーティベンダーが提供する様々な API にアクセスできます。これらは、CORS プロトコルに則ることが期待されています。制限されたヘッダーだけが Response で使用できますが、body は読み取り可能です。

構文

var myMode = request.mode;

値

RequestMode 値。

例

のスニペットは、Request.Request() コンストラクタを使って（スクリプトと同じディレクトリにある画像ファイルのために）新しいリクエストを生成してから、リクエストモードを変数に保存しています：

var myRequest = new Request('flowers.jpg');
var myMode = myRequest.mode; // 既定で "cors" を返す。

仕様

ブラウザ実装状況

[1] この機能は設定によって使えるようになります。

関連項目

• ServiceWorker API
• HTTP access control (CORS)
• HTTP