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

Aus Sicherheitsgründen können einige Header nur vom User-Agent gesteuert werden. Diese Header umfassen die verbotenen Anfrage-Header und die 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, wirft diese Methode einen TypeError. Der Name ist nicht case-sensitiv.

Rückgabewert

Eine String Sequenz, die die Werte des abgerufenen Headers repräsentiert oder null, falls 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 einen Header hinzufügen, indem Sie Headers.append verwenden und ihn dann mit get() abrufen:

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

Wenn der Header mehrere damit verbundene Werte hat, enthält der Byte-String alle Werte, in der Reihenfolge, 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
# ref-for-dom-headers-get①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
get

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch