document.referrer 是 BOM 中返回上一页面 URL 的只读属性,由浏览器根据 HTTP Referer 请求头自动设置;空值常见于直接访问、刷新、隐私模式或跨协议跳转等场景。

可以通过 document.referrer 获取当前页面的来源地址(即上一个页面的 URL)。
什么是 referrer?
document.referrer 是 BOM 中的一个只读属性,返回用户从哪个页面跳转到当前页的完整 URL 字符串。它由浏览器自动设置,通常来自 HTTP 请求头中的 Referer 字段(注意拼写少一个 r)。
常见情况:
- 用户点击链接从 A 页面跳转到 B 页面 → B 页面的
document.referrer是 A 的 URL - 用户通过书签、直接输入地址、刷新页面、或从非网页环境(如微信内置浏览器某些场景、桌面快捷方式)进入 →
referrer为空字符串"" - 从 HTTPS 页面跳转到 HTTP 页面时,出于安全策略,referrer 可能被清空(现代浏览器普遍遵循 Referrer Policy)
基本用法示例
直接读取即可:
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。
console.log(document.referrer); // 输出类似 "https://example.com/list.html"
建议使用前做空值判断:
const referrer = document.referrer || 'no-referrer';
if (referrer) {
console.log('来源页:', referrer);
} else {
console.log('无法获取来源页');
}注意 referrer 的限制与可靠性
document.referrer 不是 100% 可靠,受以下因素影响:
- 隐私设置:用户开启“禁止发送 referrer”或使用隐私/无痕模式时,可能为空
-
Referrer Policy:页面可通过
或响应头Referrer-Policy: no-referrer主动禁用 -
跨协议跳转:HTTPS → HTTP 默认不发送 referrer(除非显式设为
unsafe-url) -
JavaScript 跳转:用
window.location.replace()或location.assign()一般不影响 referrer;但location.href = url和普通链接行为一致
替代方案(当 referrer 不可用时)
如果业务强依赖来源信息,可考虑:
- 在跳转链接中手动添加查询参数,例如:
target.html?from=list,然后用URLSearchParams解析 - 使用
sessionStorage在跳转前临时存来源标识:
sessionStorage.setItem('prevPage', location.href);
目标页读取:
const prev = sessionStorage.getItem('prevPage') || 'unknown'; - 后端配合:通过服务端日志、UTM 参数、或登录态关联行为链路补全来源
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










