Access-Control-Expose-Headers header
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Der HTTP Access-Control-Expose-Headers Antwort-Header ermöglicht es einem Server anzugeben, welche Antwort-Header den in einem Browser laufenden Skripten im Rahmen einer Cross-Origin-Anfrage zugänglich gemacht werden sollen.
Standardmäßig werden nur die CORS-sicheren Antwort-Header offengelegt. Damit Clients auf andere Header zugreifen können, muss der Server diese im Access-Control-Expose-Headers Header auflisten.
| Header-Typ | Antwort-Header |
|---|---|
| Verbotener Anfrage-Header | Nein |
Syntax
Access-Control-Expose-Headers: [<header-name>[, <header-name>]*]
Access-Control-Expose-Headers: *
Direktiven
<header-name>-
Eine Liste von null oder mehr durch Kommas getrennte Header-Namen, auf die Clients in einer Antwort zugreifen dürfen. Diese sind zusätzlich zu den CORS-sicheren Antwort-Headern.
*(Wildcard)-
Jeder Header. Der Wert
*zählt nur als spezieller Wildcard-Wert für Anfragen ohne Berechtigungsnachweise (Anfragen ohne HTTP-Cookies oder HTTP-Authentifizierungsinformationen). Bei Anfragen mit Berechtigungsnachweisen wird es als der wörtliche Header-Name*behandelt.
Beispiele
Die CORS-sicheren Antwort-Header sind: Cache-Control, Content-Language, Content-Length, Content-Type, Expires, Last-Modified, Pragma. Um einen nicht CORS-sicheren Antwort-Header offenzulegen, können Sie Folgendes angeben:
Access-Control-Expose-Headers: Content-Encoding
Um zusätzlich einen benutzerdefinierten Header wie Kuma-Revision offenzulegen, können Sie mehrere durch Kommas getrennte Header angeben:
Access-Control-Expose-Headers: Content-Encoding, Kuma-Revision
Für Anfragen ohne Berechtigungsnachweise kann ein Server auch mit einem Wildcard-Wert antworten:
Access-Control-Expose-Headers: *
Ein Server kann auch mit dem Wert * bei Anfragen mit Berechtigungsnachweisen antworten, aber in diesem Fall würde er sich auf einen Header mit dem Namen * beziehen.
Spezifikationen
| Specification |
|---|
| Fetch # http-access-control-expose-headers |