Headers: append() 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 append() Methode des Headers-Interfaces fügt einen neuen Wert zu einem vorhandenen Header innerhalb eines Headers-Objekts hinzu oder fügt den Header hinzu, wenn er noch nicht existiert.

Der Unterschied zwischen set() und append() besteht darin, dass, wenn der angegebene Header bereits existiert und mehrere Werte akzeptiert, set() den bestehenden Wert mit dem neuen überschreibt, während append() den neuen Wert an das Ende der vorhandenen Werte anhängt.

Aus Sicherheitsgründen können einige Header nur vom Benutzeragenten kontrolliert werden. Diese Header umfassen die verbotenen Header-Namen und die verbotenen Antwort-Header-Namen.

Syntax

js
append(name, value)

Parameter

name

Der Name des HTTP-Headers, den Sie zum Headers-Objekt hinzufügen möchten.

value

Der Wert des HTTP-Headers, den Sie hinzufügen möchten.

Rückgabewert

Keiner (undefined).

Beispiele

Ein leeres Headers-Objekt zu erstellen ist einfach:

js
const myHeaders = new Headers(); // Currently empty

Sie könnten einen Header mit append() hinzufügen:

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

Wenn der angegebene Header bereits existiert, ändert append() seinen Wert auf den angegebenen Wert. Wenn der angegebene Header bereits existiert und mehrere Werte akzeptiert, fügt append() den neuen Wert an das Ende der Wertmenge an:

js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'

Um den alten Wert mit einem neuen zu überschreiben, verwenden Sie Headers.set.

Spezifikationen

Specification
Fetch Standard
# ref-for-dom-headers-append①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch