credentials 只读特性在 Request interface indicates whether the user agent should send cookies from the other domain in the case of cross-origin requests.

句法

var myCred = request.credentials;
					

A RequestCredentials dictionary value indicating whether the user agent should send cookies from the other domain in the case of cross-origin requests. Possible values are:

  • omit : Never send or receive cookies.
  • same-origin : Send user credentials (cookies, basic http auth, etc..) if the URL is on the same origin as the calling script. This is the default value.
  • 包括 : Always send user credentials (cookies, basic http auth, etc..), even for cross-origin calls.

This is similar to XHR’s withCredentials flag, but with three available values instead of two.

范例

In the following snippet, we create a new request using the Request.Request() constructor (for an image file in the same directory as the script), then save the request credentials in a variable:

var myRequest = new Request('flowers.jpg');
var myCred = myRequest.credentials; // returns "same-origin" by default
					

规范

规范 状态 注释
Fetch
The definition of 'credentials' in that specification.
实时标准 初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
credentials Chrome 42
42
41 Disabled
Disabled From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge 14 Firefox 39
39
34 Disabled
Disabled From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE No Opera 29
29
28 Disabled
Disabled From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari 10.1 WebView Android 42 Chrome Android 42 Firefox Android Yes Opera Android 29
29
28 Disabled
Disabled From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS 10.3 Samsung Internet Android 4.0
默认值 same-origin Chrome 72 Edge 18 Firefox 61 IE No Opera 55 Safari 12.1 WebView Android 72 Chrome Android 72 Firefox Android Yes Opera Android No Safari iOS 12.2 Samsung Internet Android 11.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

元数据

  • 最后修改:
  1. Request
  2. 构造函数
    1. Request()
  3. 特性
    1. body
    2. bodyUsed
    3. cache
    4. context
    5. credentials
    6. destination
    7. headers
    8. integrity
    9. method
    10. mode
    11. redirect
    12. referrer
    13. referrerPolicy
    14. url
  4. 方法
    1. arrayBuffer()
    2. blob()
    3. clone()
    4. formData()
    5. json()
    6. text()

版权所有  © 2014-2026 乐数软件    

工业和信息化部: 粤ICP备14079481号-1