Headers: get() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2017 browserübergreifend verfügbar.
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
| Spezifikation |
|---|
| Fetch # ref-for-dom-headers-get① |