HTMLLinkElement: thuộc tính referrerPolicy
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
* Some parts of this feature may have varying levels of support.
Thuộc tính referrerPolicy của giao diện HTMLLinkElement phản ánh thuộc tính HTML referrerpolicy của phần tử <link> xác định referrer nào được gửi khi tải tài nguyên.
Xem tiêu đề HTTP Referrer-Policy để biết chi tiết.
Giá trị
Một chuỗi; một trong các giá trị sau:
no-referrer-
Tiêu đề
Referersẽ bị bỏ qua hoàn toàn. Không có thông tin referrer nào được gửi cùng với yêu cầu. no-referrer-when-downgrade-
URL được gửi làm referrer khi mức bảo mật giao thức giữ nguyên (ví dụ: HTTP→HTTP, HTTPS→HTTPS), nhưng không được gửi đến đích kém bảo mật hơn (ví dụ: HTTPS→HTTP).
origin-
Chỉ gửi nguồn gốc của tài liệu làm referrer trong mọi trường hợp. Tài liệu
https://example.com/page.htmlsẽ gửi referrerhttps://example.com/. origin-when-cross-origin-
Gửi URL đầy đủ khi thực hiện yêu cầu cùng nguồn gốc, nhưng chỉ gửi nguồn gốc của tài liệu cho các trường hợp khác.
same-origin-
Một referrer sẽ được gửi cho các nguồn gốc cùng trang, nhưng yêu cầu xuyên nguồn gốc sẽ không chứa thông tin referrer.
strict-origin-
Chỉ gửi nguồn gốc của tài liệu làm referrer khi mức bảo mật giao thức giữ nguyên (ví dụ: HTTPS→HTTPS), nhưng không gửi đến đích kém bảo mật hơn (ví dụ: HTTPS→HTTP).
strict-origin-when-cross-origin(mặc định)-
Đây là hành vi mặc định của trình duyệt khi không có chính sách nào được chỉ định. Gửi URL đầy đủ khi thực hiện yêu cầu cùng nguồn gốc, chỉ gửi nguồn gốc khi mức bảo mật giao thức giữ nguyên (ví dụ: HTTPS→HTTPS), và không gửi tiêu đề nào đến đích kém bảo mật hơn (ví dụ: HTTPS→HTTP).
unsafe-url-
Gửi URL đầy đủ khi thực hiện yêu cầu cùng nguồn gốc hoặc xuyên nguồn gốc. Chính sách này sẽ làm rò rỉ nguồn gốc và đường dẫn từ tài nguyên được bảo vệ TLS đến các nguồn gốc không bảo mật. Hãy cân nhắc kỹ tác động của thiết lập này.
Ví dụ
const links = document.getElementsByTagName("link");
links[0].referrerPolicy; // "no-referrer"
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| HTML> # dom-link-referrerpolicy> |