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接口的只读属性，用于表示用户代理是否应该在跨域请求的情况下从其他域发送 cookies。这与 XHR 的 withCredentials 标志相似，不同的是有三个可选值（后者是两个）：

  • omit: 从不发送 cookies.
  • same-origin: 只有当 URL 与响应脚本同源才发送 cookies、HTTP Basic authentication 等验证信息.(浏览器默认值，在旧版本浏览器，例如 safari 11 依旧是 omit，safari 12 已更改)
  • include: 不论是不是跨域的请求，总是发送请求资源域在本地的 cookies、HTTP Basic authentication 等验证信息。

语法

js
var myCred = request.credentials;

Value

A RequestCredentials value.

举例

在以下代码中，我们使用Request.Request()创建了一个新的 request（为了一个与脚本在同一目录下的图片文件），接着将 request credentials 存入一个变量：

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

规范

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

浏览器兼容性

BCD tables only load in the browser

See also