Headers: get()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die get()-Methode des Headers-Interfaces liefert einen Byte-String aller Werte eines Headers innerhalb eines Headers-Objekts mit einem gegebenen Namen. Existiert der angeforderte Header nicht im Headers-Objekt, gibt sie null zurück.

Aus Sicherheitsgründen können einige Header nur vom User-Agent kontrolliert werden. Diese Header umfassen die verbotenen Header-Namen und verbotenen Antwort-Header-Namen.

Syntax

js
get(name)

Parameter

name

Der Name des HTTP-Headers, dessen Werte Sie aus dem Headers-Objekt abrufen möchten. Wenn der angegebene Name nicht der Name eines HTTP-Headers ist, löst diese Methode einen TypeError aus. Der Name ist nicht case-sensitiv.

Rückgabewert

Eine String-Sequenz, die die Werte des abgerufenen Headers darstellt, oder null, wenn dieser Header nicht gesetzt ist.

Beispiele

Ein leeres Headers-Objekt zu erstellen ist einfach:

js
const myHeaders = new Headers(); // Currently empty
myHeaders.get("Not-Set"); // Returns null

Sie könnten diesem mit Headers.append einen Header hinzufügen und ihn dann mit get() abrufen:

js
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns "image/jpeg"

Falls der Header mehrere Werte enthält, wird der Byte-String alle Werte in der Reihenfolge enthalten, in der sie dem Headers-Objekt hinzugefügt wurden:

js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
myHeaders
  .get("Accept-Encoding")
  .split(",")
  .map((v) => v.trimStart()); // Returns [ "deflate", "gzip" ]

Spezifikationen

Specification
Fetch Standard
# ref-for-dom-headers-get①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch