Request.credentials
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
credentials は Request インターフェイスの読み取り専用プロパティで、オリジン間リクエストの場合に、ユーザーエージェントが他のドメインからクッキーを送信または受信するべきかどうかを示すものです。
値
RequestCredentials 辞書の値で、オリジン間リクエストの場合、ユーザーエージェントが他のドメインからクッキーを送信するか受信するかを示します。使用可能な値は以下の通りです。
omit-
クッキーを送受信しません。
same-origin-
URL が呼び出し元のスクリプトと同一オリジンだった場合のみ、ユーザーの資格情報 (HTTP Basic 認証、など) を送信します。 これが既定値です。
include-
オリジン間の呼び出しであっても、常にユーザーの資格情報 (クッキー、HTTP Basic 認証、など) を送信します。
これは XHR の withCredentials フラグと似ていますが、有効な値が 2 つではなく 3 つあります。
例
次のスニペットは、Request.Request() コンストラクターを使って（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを生成してから、リクエストの資格情報を変数に保存しています。
js
const myRequest = new Request("flowers.jpg");
const myCred = myRequest.credentials; // 既定で "same-origin" を返す
仕様書
| Specification |
|---|
| Fetch Standard # ref-for-dom-request-credentials② |
ブラウザーの互換性
BCD tables only load in the browser