XMLHttpRequest: phương thức setRequestHeader()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers, except for Service Workers.

Phương thức XMLHttpRequest setRequestHeader() đặt giá trị của một tiêu đề yêu cầu HTTP. Khi sử dụng setRequestHeader(), bạn phải gọi nó sau khi gọi open(), nhưng trước khi gọi send(). Nếu phương thức này được gọi nhiều lần với cùng một tiêu đề, các giá trị được hợp nhất thành một tiêu đề yêu cầu duy nhất.

Mỗi lần bạn gọi setRequestHeader() sau lần gọi đầu tiên, văn bản được chỉ định sẽ được nối vào cuối nội dung tiêu đề hiện có.

Nếu không có tiêu đề Accept nào được thiết lập bằng cách sử dụng phương thức này, một tiêu đề Accept với loại "*/*" sẽ được gửi cùng với yêu cầu khi send() được gọi.

Vì lý do bảo mật, có một số tiêu đề yêu cầu bị cấm có giá trị được kiểm soát bởi tác nhân người dùng. Bất kỳ nỗ lực nào đặt giá trị cho một trong những tiêu đề đó từ mã JavaScript frontend sẽ bị bỏ qua mà không có cảnh báo hoặc lỗi.

Ngoài ra, tiêu đề HTTP Authorization có thể được thêm vào yêu cầu, nhưng sẽ bị xóa nếu yêu cầu được chuyển hướng xuyên nguồn gốc.

Note: Đối với các trường tùy chỉnh của bạn, bạn có thể gặp ngoại lệ "not allowed by Access-Control-Allow-Headers in preflight response" khi gửi yêu cầu xuyên miền. Trong tình huống này, bạn cần thiết lập Access-Control-Allow-Headers trong tiêu đề phản hồi ở phía máy chủ.