Request: credentials 属性

Baseline 已广泛支持

此特性已得到良好确立,可跨多种设备和浏览器版本使用。自 2017 年 3 月起,所有浏览器均支持此特性。

注意:此功能在 Web Workers 中可用。

Request 接口的只读属性 credentials 反映了在 Request() 构造函数中为 credentials 选项提供的值。它决定了浏览器是否会发送凭据随请求发送,以及是否会响应 Set-Cookie 响应头。

凭据包括 cookie、TLS 客户端证书或包含用户名和密码的身份验证头。

有关更多详细信息,请参阅 包含凭据

一个字符串,其值可能为以下之一:

omit

从不在请求中发送凭据,也不在响应中包含凭据。

same-origin

仅对同源请求发送和包含凭据。这是默认值。

include

始终包含凭据,即使对于跨域请求也是如此。

示例

在下面的代码片段中,我们使用 Request() 构造函数创建了一个新请求(针对与脚本位于同一目录下的图像文件),然后将请求凭据保存在一个变量中

js
const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default

规范

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

浏览器兼容性

另见