Headers: phương thức append()
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.
Note: This feature is available in Web Workers.
Phương thức append() của giao diện Headers thêm một giá trị mới vào một header hiện có bên trong đối tượng Headers, hoặc thêm header nếu nó chưa tồn tại.
Sự khác biệt giữa set() và append() là nếu header được chỉ định đã tồn tại và chấp nhận nhiều giá trị, set() sẽ ghi đè giá trị hiện có bằng giá trị mới, trong khi append() sẽ nối giá trị mới vào cuối tập giá trị.
Vì lý do bảo mật, một số header chỉ có thể được user agent kiểm soát. Những header này bao gồm các forbidden request headers và các forbidden response header names.
Cú pháp
append(name, value)
Tham số
Giá trị trả về
Không có (undefined).
Ví dụ
Tạo một đối tượng Headers rỗng là rất đơn giản:
const myHeaders = new Headers(); // Currently empty
Bạn có thể thêm một header vào đó bằng append():
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
Nếu header được chỉ định đã tồn tại, append() sẽ đổi giá trị của nó thành giá trị đã chỉ định. Nếu header được chỉ định đã tồn tại và chấp nhận nhiều giá trị, append() sẽ nối giá trị mới vào cuối tập giá trị:
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'
Để ghi đè giá trị cũ bằng giá trị mới, hãy dùng Headers.set.
Thông số kỹ thuật
| Specification |
|---|
| Fetch # ref-for-dom-headers-append① |