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项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记(深入)”;
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:页面可通过
<meta name="referrer" content="no-referrer">或响应头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 参数、或登录态关联行为链路补全来源

















