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.

メモ: この機能はウェブワーカー内で利用可能です。

credentialsRequest インターフェイスの読み取り専用プロパティで、credentials オプションで指定された Request() コンストラクターの値を反映します。このプロパティは、ブラウザーがリクエストに資格情報を送信するかどうか、また、Set-Cookie レスポンスヘッダーが尊重されるかどうかを決定します。

資格情報とは、クッキー、TLS クライアント証明書、ユーザー名とパスワードを格納する認証ヘッダーなどです。

詳しくは資格情報を含めるを参照してください。

文字列で、以下の値のうちのいずれかです。

omit

リクエストに資格情報を記載したり、レスポンスに資格情報を含めたりしません。

same-origin

同一オリジンリクエストにのみ、資格情報を送信したり含めたりします。

include

オリジン間のリクエストであっても、常に資格情報を含めます。

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

js
const request = new Request("flowers.jpg");
const credentials = request.credentials; // 既定で "same-origin" を返す

仕様書

Specification
Fetch
# ref-for-dom-request-credentials②

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
credentials
Default value same-origin

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報