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 der Headers Schnittstelle gibt einen Byte-String aller Werte eines Headers innerhalb eines Headers-Objekts mit einem gegebenen Namen zurück. Existiert der angeforderte Header nicht im Headers-Objekt, gibt sie null zurück.

Aus Sicherheitsgründen können einige Header nur vom Benutzeragent gesteuert werden. Zu diesen Headern gehören die verbotenen Anforderungsheader und verbotenen Antwortheader-Namen.

Syntax

get(name)

Parameter

name: Der Name des HTTP-Headers, dessen Werte Sie vom 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:

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

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

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

Wenn der Header mehrere Werte damit verknüpft hat, wird der Byte-String alle diese Werte enthalten, in der Reihenfolge, in der sie dem Headers-Objekt hinzugefügt wurden:

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 # ref-for-dom-headers-get①