Access-Control-Expose-Headers


Access-Control-Expose-Headers

响应首部 Access-Control-Expose-Headers 列出了哪些首部可以作为响应的一部分暴露给外部。

默认情况下,只有七种 simple response headers (简单响应首部)可以暴露给外部:

如果想要让客户端可以访问到其他的首部信息,可以将它们在 Access-Control-Expose-Headers 里面列出来。

语法

1
Access-Control-Expose-Headers: <header-name>, <header-name>, ...

指令

示例

想要暴露一个非简单响应首部,可以这样指定:

1
Access-Control-Expose-Headers: Content-Length

想要额外暴露自定义的首部,例如 X-Kuma-Revision,可以指定多个,用逗号隔开:

1
Access-Control-Expose-Headers: Content-Length, X-Kuma-Revision

注意

当前端实现文件下载功能时,通过 fetch 函数无法获取请求头中的 Content-Disposition 参数时,需要看下后端是否通过 Access-Control-Expose-Headers 暴露了这个参数。

Access-Control-Expose-Headers
js无法获取响应header的Content-Disposition字段(2020)