この記事は編集レビューを必要としています。ぜひご協力ください。
これは実験段階の機能です。
この機能は複数のブラウザで開発中の状態にあります。各ブラウザで用いるために、適切なベンダー接頭辞が必要な場合があります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザの将来のバージョンで変更になる可能性があることに注意してください。
Request
インターフェースの credentials
読み取り専用プロパティは、クロスオリジンリクエストの場合、ユーザーエージェントが ほかのドメインからクッキーを送信すべきかどうかを示します。これは XHR の withCredentials フラグと似ていますが、(2 つではなく)3 つの値があります:
omit:
決してクッキーを送信しない。same-origin:
URL が呼び出し元のスクリプトと同一オリジンだった場合のみ、クッキーを送信する。include:
クロスオリジンの呼び出しであっても、常にクッキーを送信する。
構文
var myCred = request.credentials;
値
例
次のスニペットは、Request.Request()
コンストラクタを使って(スクリプトと同じディレクトリにある画像ファイルのために)新しいリクエストを生成してから、リクエストの credentials を変数に保存しています:
var myRequest = new Request('flowers.jpg'); var myCred = myRequest.credentials; // 既定では "omit" を返す。
仕様
仕様 | 状態 | コメント |
---|---|---|
Fetch The definition of 'credentials' in that specification. |
Living Standard | Initial definition |
ブラウザ実装状況
機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
基本サポート | 42 41[1] |
39 (39) 34[1] |
未サポート |
29 |
未サポート |
機能 | Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
基本サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
[1] この機能は設定によって使えるようになります。