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 der Headers-Schnittstelle fügt einen neuen Wert zu einem existierenden 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 set() den existierenden Wert überschreibt, wenn der angegebene Header bereits existiert und mehrere Werte akzeptiert, während append() den neuen Wert an das Ende der vorhandenen Wertemenge anhängt.

Aus Sicherheitsgründen können einige Header nur durch den User-Agent kontrolliert werden. Diese Header umfassen die verbotenen Anforderungsheader und verbotenen Antwortheadernamen.

Syntax

append(name, value)

Parameter

name: Der Name des HTTP-Headers, den Sie dem 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:

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

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

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

Wenn der angegebene Header bereits existiert, ändert append() seinen Wert zu dem angegebenen Wert. Wenn der angegebene Header bereits existiert und mehrere Werte akzeptiert, hängt append() den neuen Wert an das Ende der Wertemenge an:

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

Um den alten Wert durch einen neuen zu überschreiben, verwenden Sie Headers.set.

Spezifikationen

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