<meta name="referrer">

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

<meta> 元素的 name 屬性的 referrer 值用於控制文件發出的請求的 HTTP Referer 頭部。如果指定了,您將使用 <meta> 元素中的 content 屬性,並將其作為一個關鍵詞值來定義 referrer。

例如,下面的 <meta> 元素將文件的 源站 作為 referrer 傳送。

html
<meta name="referrer" content="origin" />

警告: 動態插入 <meta name="referrer">(使用 document.write()appendChild())會導致 referrer 的行為不可預測。當定義了多個衝突的策略時,將應用 no-referrer 策略。

用法說明

<meta name="referrer"> 元素具有以下附加屬性:

content

設定文件的 referrer。必須定義此屬性。接受以下值之一:

no-referrer

不傳送 HTTP Referer 頭部。

origin

傳送文件的源站。

no-referrer-when-downgrade

當目標與當前頁面同源或更安全(HTTP(S)→HTTPS)時,傳送完整的 URL;當目標不如當前頁面安全(HTTPS→HTTP)時,不傳送 referrer。這是預設行為。

origin-when-cross-origin

對於同源請求,傳送完整的 URL(已去除引數);對於其他情況,僅傳送源站。

same-origin

對於同源請求,傳送完整的 URL(已去除引數)。跨域請求將不包含 referrer 頭部。

strict-origin

當目標與當前頁面同源或更安全(HTTP(S)→HTTPS)時,傳送源站;當目標不如當前頁面安全(HTTPS→HTTP)時,不傳送 referrer。

strict-origin-when-cross-origin

對於同源請求,傳送完整的 URL(已去除引數)。當目標與當前頁面同源或更安全(HTTP(S)→HTTPS)時,傳送源站。否則,不傳送 referrer。

unsafe-URL

對於同源或跨域請求,傳送完整的 URL(已去除引數)。

示例

從請求中移除 referrer

以下 <meta> 元素指定文件不應傳送來自該文件的 HTTP 請求的 Referer 頭部。

html
<meta name="referrer" content="no-referrer" />

規範

規範
HTML
# meta-referrer

瀏覽器相容性

另見