HTTP Access-Control-Expose-Headers Header

Der HTTP-Header Access-Control-Expose-Headers ist ein Response-Header, der festlegt, welche Response-Header vom Browser an das JavaScript des Clients weitergegeben werden dürfen. Standardmäßig sind nur wenige CORS-safe Headers zugänglich.

Typ

Response-Header

Syntax

Der Header listet die exponierten Response-Header als kommaseparierte Liste auf.

http 
Access-Control-Expose-Headers: X-RateLimit-Limit, X-RateLimit-Remaining
Access-Control-Expose-Headers: *

Direktiven

Die Direktiven definieren, welche Response-Header JavaScript lesen darf.

<header-name>
Name eines Response-Headers der exponiert werden soll. Mehrere Werte kommasepariert.
*
Wildcard für alle Header außer Authorization. Funktioniert nur ohne Credentials.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Access-Control-Expose-Headers-Header.

Beispiel 1 Rate-Limit Informationen

http 
Access-Control-Expose-Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

API exponiert Rate-Limit-Header damit Client verbleibende Requests anzeigen und Throttling implementieren kann.

Beispiel 2 Pagination Headers

http 
Access-Control-Expose-Headers: Link, X-Total-Count, X-Page-Number

REST API macht Pagination-Metadaten zugänglich für clientseitige Navigation durch große Datensätze.

Beispiel 3 Custom Business Headers

http 
Access-Control-Expose-Headers: X-Request-Id, X-Processing-Time, X-API-Version

API exponiert technische Metadaten für Debugging, Monitoring und Version-Management im Client.

CORS Response Header Access Flow

CORS Response Header Exposition für JavaScript-Zugriff

Vorteile für die Systemarchitektur

  • Erweiterte Client-Features: Rate-Limiting, Pagination und Caching clientseitig implementierbar
  • Verbesserte Debugging-Erfahrung: Request-IDs und Timing-Informationen für Entwickler zugänglich
  • API-Transparenz: Clients erhalten vollständige Metadaten für intelligente Request-Strategien

Spezifikation

Fetch Standard – CORS Protocol and HTTP-Access-Control-Expose-Headers https://fetch.spec.whatwg.org/#http-access-control-expose-headers

Weitere Spezifikationen

Access-Control-Allow-Origin Header, ETag Header