大网数据广告活动
Web 标准与前端开发

XMLHttpRequest:setRequestHeader() 方法

· 52CE 我爱测

XMLHttpRequest API window_and_worker_except_service

XMLHttpRequest API window_and_worker_except_service

XMLHttpRequest 的 setRequestHeader() 方法设置 HTTP 请求头部的值。此方法必须在 XMLHttpRequest.open 方法和 XMLHttpRequest.send 之间调用。如果多次对同一个请求头赋值,只会生成一个合并了多个值的请求头。

在第一次调用 setRequestHeader() 之后的每次调用,指定文本会附加到存在的标头内容的末尾。

如果没有设置 Accept 标头,则在调用 XMLHttpRequest.send 时,会随请求发送一个类型为 "*/*" 的 Accept 标头。

安全起见,有些Forbidden_request_header的值只能由用户代理控制。任何通过前端 JavaScript 代码为其中一个标头设置值的尝试都将被忽略,不会出现警告或错误。

另外,Authorization HTTP 标头可以添加到请求中,但如果请求被跨源重定向,则会被删除。

[!NOTE] 对于自定义字段,在跨域请求时可能遇到“not allowed by Access-Control-Allow-Headers in preflight response”异常,你可能需要在你的服务端设置 Access-Control-Allow-Headers。

语法

setRequestHeader(header, value)

参数

  • header
    • : 要设置的标头的名称。
  • value
    • : 要设置的标头正文的值。

返回值

无(undefined)。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。