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 einem existierenden Header innerhalb eines Headers-Objekts einen neuen Wert hinzu oder fügt den Header hinzu, falls er noch nicht existiert.

Der Unterschied zwischen set() und append() besteht darin, dass set() den existierenden Wert mit dem neuen überschreibt, wenn der angegebene Header bereits existiert und mehrere Werte akzeptiert, während append() den neuen Wert am Ende der Wertemenge anfügt.

Aus Sicherheitsgründen können einige Header nur durch den User-Agent gesteuert werden. Zu diesen Headern gehören die verbotenen Anforderungsheader und die verbotenen Antwortheader-Namen.

Syntax

js
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:

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

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

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

Wenn der angegebene Header bereits existiert, wird append() seinen Wert in den angegebenen Wert ändern. Wenn der angegebene Header bereits existiert und mehrere Werte akzeptieren kann, wird append() den neuen Wert am Ende der Wertemenge anfügen:

js
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①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
append

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch