文件:referrer 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Document.referrer 屬性返回連結到當前頁面的頁面的 URI

如果使用者直接導航到該頁面(而不是透過連結,例如透過使用書籤),則該值為一個空字串。由於此屬性僅返回一個字串,因此您無法透過文件物件模型 (DOM) 訪問引薦頁面。

<iframe> 內部,對於同源請求,Document.referrer 最初將設定為父級 Window.locationhref。對於跨源請求,預設情況下,它將是父級 Window.locationorigin。有關更多資訊,請參閱 Referrer-Policy: strict-origin-when-cross-origin 文件。

示例

以下將記錄一個包含文件的引薦來源的字串。

js
console.log(document.referrer);

如果使用者透過類似 <a href="https://www.w3.org/">W3</a> 的連結導航到該頁面,則會輸出前一個域,例如 developer.mozilla.org。如果使用者直接導航到該頁面,則會輸出一個空字串。

規範

規範
HTML
# dom-document-referrer-dev

瀏覽器相容性