此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Request.credentials

基线 广泛可用

自 2017年3月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

credentialsRequest接口的只读属性,用于表示用户代理是否应该在跨域请求的情况下从其他域发送 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

规范

规范
Fetch
# ref-for-dom-request-credentials②

浏览器兼容性

See also