Headers: phương thức get()

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 get() của giao diện Headers trả về một chuỗi byte chứa tất cả giá trị của một header trong đối tượng Headers với tên đã cho. Nếu header được yêu cầu không tồn tại trong đối tượng Headers, phương thức trả về null.

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 headerscác forbidden response header names.

Cú pháp

js
get(name)

Tham số

name

Tên của HTTP header mà bạn muốn truy xuất giá trị từ đối tượng Headers. Nếu tên đã cho không khớp với sản xuất field-name trong đặc tả HTTP, phương thức này sẽ ném ra TypeError. Tên không phân biệt hoa thường.

Giá trị trả về

Một chuỗi String biểu diễn các giá trị của header được truy xuất, hoặc null nếu header này chưa được đặt.

Ví dụ

Tạo một đối tượng Headers rỗng là rất đơn giản:

js
const myHeaders = new Headers(); // Currently empty
myHeaders.get("Not-Set"); // Returns null

Bạn có thể thêm một header vào đó bằng Headers.append, rồi truy xuất nó bằng get():

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

Nếu header có nhiều giá trị liên kết với nó, chuỗi byte sẽ chứa tất cả các giá trị theo đúng thứ tự chúng được thêm vào đối tượng Headers:

js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
myHeaders
  .get("Accept-Encoding")
  .split(",")
  .map((v) => v.trimStart()); // Returns [ "deflate", "gzip" ]

Thông số kỹ thuật

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

Tương thích trình duyệt

Xem thêm