credentials
是Request
接口的只读属性,用于表示用户代理是否应该在跨域请求的情况下从其他域发送cookies。这与XHR的withCredentials 标志相似,不同的是有三个可选值(后者是两个):
omit
: 从不发送cookies.same-origin
: 只有当URL与响应脚本同源才发送 cookies、 HTTP Basic authentication 等验证信息.(浏览器默认值,在旧版本浏览器,例如safari 11依旧是omit,safari 12已更改)include
: 不论是不是跨域的请求,总是发送请求资源域在本地的 cookies、 HTTP Basic authentication 等验证信息.
语法
var myCred = request.credentials;
Value
A RequestCredentials
value.
举例
在以下代码中,我们使用Request.Request()
创建了一个新的request(为了一个与脚本在同一目录下的图片文件), 接着将request credentials存入一个变量:
var myRequest = new Request('flowers.jpg');
var myCred = myRequest.credentials; // returns "same-origin" by default
说明
Specification | Status | Comment |
---|---|---|
Fetch credentials |
Living Standard | Initial definition |
浏览器兼容性
BCD tables only load in the browser