Headers: Headers() Konstruktor
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.
Der Headers()-Konstruktor erstellt ein neues
Headers-Objekt.
Syntax
new Headers()
new Headers(init)
Parameter
initOptional-
Ein Objekt, das alle HTTP-Header enthält, die Sie in Ihrem
Headers-Objekt vorab einfügen möchten. Dies kann ein einfaches Objekt-Literal mitString-Werten, ein Array von Name-Wert-Paaren, bei dem jedes Paar ein String-Array mit 2 Elementen ist, oder ein bestehendesHeaders-Objekt sein. Im letzten Fall kopiert das neueHeaders-Objekt seine Daten aus dem vorhandenenHeaders-Objekt.
Beispiele
Ein leeres Headers-Objekt zu erstellen, ist einfach:
const myHeaders = new Headers(); // Currently empty
Sie können diesem ein Header hinzufügen, indem Sie Headers.append verwenden:
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
Oder Sie können die gewünschten Header hinzufügen, während das Headers-Objekt erstellt wird. Im folgenden Code-Schnipsel erstellen wir ein neues Headers-Objekt und fügen einige Header hinzu, indem wir dem Konstruktor ein init-Objekt als Argument übergeben:
const httpHeaders = {
"Content-Type": "image/jpeg",
"X-My-Custom-Header": "Zeke are cool",
};
const myHeaders = new Headers(httpHeaders);
Sie können nun ein weiteres Headers-Objekt erstellen, indem Sie ihm das erste
Headers-Objekt als init-Objekt übergeben:
const secondHeadersObj = new Headers(myHeaders);
secondHeadersObj.get("Content-Type"); // Would return 'image/jpeg' — it inherits it from the first headers object
Sie können auch die gewünschten Header hinzufügen, während das Headers-Objekt erstellt wird, indem Sie ein zweidimensionales Array verwenden, um mehrere Header mit denselben Werten hinzuzufügen. Im folgenden Code-Schnipsel erstellen wir ein neues Headers-Objekt mit mehreren Set-Cookie-Headern, indem wir dem Konstruktor ein init-Array als Argument übergeben:
const headers = [
["Set-Cookie", "greeting=hello"],
["Set-Cookie", "name=world"],
];
const myHeaders = new Headers(headers);
Spezifikationen
| Specification |
|---|
| Fetch> # ref-for-dom-headers①> |
Browser-Kompatibilität
Loading…