Headers: append() 方法

Baseline 已廣泛支援

此特性已得到良好確立,可跨多種裝置和瀏覽器版本使用。自 2017 年 3 月起,所有瀏覽器均支援此特性。

注意:此功能在 Web Workers 中可用。

Headers 介面的 append() 方法將新值追加到 Headers 物件中現有 header 的末尾,如果該 header 不存在,則新增該 header。

set()append() 之間的區別在於,如果指定的 header 已經存在且接受多個值,則 set() 將用新值覆蓋現有值,而 append() 會將新值追加到現有值集的末尾。

出於安全原因,某些標頭只能由使用者代理控制。這些標頭包括禁止的請求標頭禁止的響應標頭名稱

語法

js
append(name, value)

引數

name

要新增到 Headers 物件的 HTTP header 的名稱。

value

要新增的 HTTP header 的值。

返回值

無(undefined)。

示例

建立空的 Headers 物件很簡單

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

您可以使用 append() 新增 header

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

如果指定的 header 已經存在,append() 將更改其值為指定值。如果指定的 header 已經存在並且接受多個值,append() 會將新值追加到值集的末尾

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

要用新值覆蓋舊值,請使用 Headers.set

規範

規範
Fetch
# ref-for-dom-headers-append①

瀏覽器相容性

另見