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 März 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. Wenn der angeforderte Header im Headers-Objekt
nicht existiert, gibt er null zurück.
Aus Sicherheitsgründen können einige Header nur vom Benutzeragenten kontrolliert werden. Zu diesen Headern gehören die forbidden request headers und forbidden response header names.
Syntax
get(name)
Parameter
name-
Der Name des HTTP-Headers, dessen Werte Sie aus dem
Headers-Objekt abrufen möchten. Wenn der angegebene Name nicht mit der field-name Produktion in der HTTP-Spezifikation übereinstimmt, löst diese Methode einenTypeErroraus. Der Name ist nicht case-sensitiv.
Rückgabewert
Eine String-Sequenz, die die Werte des abgerufenen Headers oder
null darstellt, 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 mit Headers.append einen Header hinzufügen und diesen dann mit get() abrufen:
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns "image/jpeg"
Wenn der Header mehrere damit verbundene Werte hat, wird der Byte-String alle Werte in der Reihenfolge enthalten, 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① |