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
append(name, value)
Parameter
Rückgabewert
Keiner (undefined
).
Beispiele
Ein leeres Headers
-Objekt zu erstellen ist einfach:
const myHeaders = new Headers(); // Currently empty
Sie könnten diesem 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, 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:
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 GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
append |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support