此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
XMLHttpRequest:withCredentials 属性
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
XMLHttpRequest.withCredentials 属性是一个布尔值,它指示了是否该使用类似 cookie、Authorization 标头或者 TLS 客户端证书等凭据进行跨站点访问控制(Access-Control)请求。设置withCredentials 对同源请求是无效的。
此外,这个标志还用于指示何时在响应中忽略 cookie。默认值是false。除非在发送XMLHttpRequest 请求之前,将withCredentials 设置为true,否则来自不同域的XMLHttpRequest 响应无法为自己的域设置 cookie 值。而通过设置withCredentials 为 true 获得第三方 cookie,仍将遵循同源策略,因此请求的脚本无法通过document.cookie 或者响应标头访问。
备注:永远不会影响到同源请求。
备注:不同域下的XmlHttpRequest 响应,不论其Access-Control- 标头设置什么值,都无法为它自身站点设置 Cookie 值,除非它在请求之前将withCredentials 设为 true。
In this article
值
布尔值。
示例
js
const xhr = new XMLHttpRequest();xhr.open("GET", "http://example.com/", true);xhr.withCredentials = true;xhr.send(null);规范
| Specification |
|---|
| XMLHttpRequest> # the-withcredentials-attribute> |