要获取当前页面的域名信息,最直接的方法是使用 window.location.hostname,它返回不带端口号的纯域名;如果需要带端口,用 location.host;想要协议+域名+端口的完整前缀,则用 location.origin。
很多前端开发者在处理跳转、接口地址拼接、环境判断时,都会和 location 这个全局对象打交道,它就像浏览器地址栏的翻译官,把一串复杂的 URL 拆解成你能单独调用的部分,这篇文章把 location 对象里和域名相关的属性一次讲透,并给出可直接落地的判断逻辑。
如何获取当前页面的域名:location对象的核心属性拆解
首先要明确一点:域名信息并不只有一个字段,具体取哪个值,取决于你想要的粒度,假设当前页面地址是 https://user.example.com:8080/path/page.html?id=1#top,下面是 location 对象各个属性返回的结果对比:
| 属性 | 返回值 | 说明 |
|---|---|---|
location.href |
https://user.example.com:8080/path/page.html?id=1#top |
完整URL,最常用但不推荐用它解析域名 |
location.protocol |
https: |
协议,注意自带冒号 |
location.host |
user.example.com:8080 |
主机名加端口号 |
location.hostname |
user.example.com |
主机名,不含端口号 |
location.port |
8080 |
端口号,为空字符串时代表默认端口(80或443) |
location.pathname |
/path/page.html |
路径部分 |
location.search |
?id=1 |
查询参数,含问号 |
location.hash |
#top |
锚点,含井号 |
location.origin |
https://user.example.com:8080 |
协议+主机+端口,只读属性 |
hostname、host、origin三者如何选型
三者都涉及域名,但语义完全不同。判断域名本身用hostname,它最干净,没有任何冗余符号。判断是否跨域用origin,因为跨域判断的标准是“协议+主机+端口”是否一致,而host无法单独用于这种比较。展示完整地址用href,但注意它包含路径和参数,不适合做单纯的域名匹配。
举个真实场景:你需要阻止网站在非指定域名下运行,如果用 location.hostname 去比对,就能忽略端口和协议差异,只关心域名主体,但如果你不小心用了 location.host,本地开发时域名后带了 3000,线上没有端口,比对必然失败。
location.assign、location.replace与域名跳转的关系
当你拿到当前域名后,经常要做跳转。location.assign('https://example.com') 会跳转并保留当前页面在历史记录里,用户能点返回按钮。location.replace('https://example.com') 则替换当前历史记录,用户点不了返回,这种细节在日常开发里影响很大,尤其是表单提交后跳转,用 replace 可以防止用户重复提交。
location.hostname和location.host的区别:端口对域名判断的干扰
很多新手在这两个属性上栽过跟头。location.hostname永远不带端口号,而 location.host 在端口是默认值(80或443)时,也会省略端口号,有个反直觉的细节:如果你用 location.host 判断域名,当页面是 https://example.com 时返回 example.com,当页面是 https://example.com:8443 时返回 example.com:8443,这两个值根本无法直接用 比较。
实际开发中的域名判断误区
行业共识认为,判断域名归属时应该优先使用location.hostname,然后单独处理端口逻辑。
// 正确的多环境判断思路
const host = window.location.hostname;
if (host === 'localhost' || host === '127.0.0.1') {
// 本地开发逻辑
} else if (host.endsWith('.example.com')) {
// 生产环境主域及子域逻辑
}
不要尝试从 location.host 里用 split(':')[0] 去切域名,因为如果 URL 里没有显式端口,split(':') 返回的数组只有一个元素,取 [0] 虽然还能得到域名,但代码可读性极差。字符串截取不如直接用 hostname 来得干净。
获取当前域名后常见的URL拼接陷阱
拿到了域名,下一步通常是拼接口地址,这里有个非常大的坑:不要直接用 location.hostname 拼后端 API,因为你的站点可能同时存在 HTTP 和 HTTPS,一旦用 location.hostname 拼出来的地址写死了 http://,用户在 HTTPS 页面下就会被浏览器拦截混合内容,正确做法是用 location.origin 作为前缀,它会自动带上当前页面的协议:
// 推荐:自动继承当前协议 const apiBase = window.location.origin; // 不推荐:硬编码协议,翻车概率高 const badBase = 'https://' + window.location.hostname;
前端通过location判断域名环境的实战操作
开发、测试、生产环境往往共享同一套代码,但后端接口地址完全不同,你不可能每次上线都手动改代码,这时用 location 做环境自动识别非常高效。
本地开发与生产环境的域名区分策略
最常见的判断依据是 hostname 的值,本地开发通常是 localhost 或 0.0.1,测试环境可能是 test.example.com 或带 -dev 前缀的域名,业内专家常用的一种简洁模式如下:
- 提取
location.hostname - 定义一个环境映射表
- 根据映射表匹配出当前环境对应的 API 地址
const envMap = {
'localhost': 'http://127.0.0.1:8080/api',
'127.0.0.1': 'http://127.0.0.1:8080/api',
'test.example.com': 'https://test-api.example.com',
};
const host = window.location.hostname;
const apiBase = envMap[host] || 'https://api.example.com';
这种写法的好处是:新增环境只需改映射表,不需要动逻辑代码,当用户问你“如何获取当前页面的域名”时,通常背后的真实需求就是这种环境区分。
单页应用路由场景下的location域名读取
如果项目使用 Vue Router 或 React Router 的 history 模式,地址栏是由 History API 控制的。location.href 会随着路由变化实时更新,但 location.hostname 和 location.origin 是稳定不变的。无论路由怎么切,域名信息都恒定,这给全局配置读取提供了便利。
如果是 hash 模式(地址栏带 ),情况则不同。location.hash 会包含路由信息,但 location.hostname 依然不受影响,所以在单页应用里,用 location.origin 做全局 API 前缀是最稳妥的,因为它不会因为路由模式不同而产生差异。
移动端页面与微信浏览器的域名适配
移动端存在一类特殊场景:页面本身运行在微信内置浏览器里,此时通过 location.hostname 仍能正确获取到业务域名,但部分开发者误以为 UA 能代替域名判断,UA 只能告诉你“当前是微信”,不能告诉你“当前是哪个站点”。正确的做法是先用 UA 判断环境,再用 location.hostname 判断具体业务,例如某页面需要区分是跑在微信内部还是外部浏览器:
- 第一步:读取
navigator.userAgent匹配MicroMessenger字样 - 第二步:读取
location.hostname匹配具体站点名 - 第三步:根据两个结果决定是否启用微信 JS-SDK
location对象获取域名的兼容性与浏览器差异
主流浏览器对 location 对象的标准属性支持几乎一致,但 location.origin 是一个相对较新的属性,它并非无法使用,只是极端老旧浏览器可能会遗漏,对于推广页、低版本 WebView 这类控制范围较弱的环境,建议做一层防护:
function getOrigin() {
if (window.location.origin) {
return window.location.origin;
}
// 兼容不支持 origin 属性的场景
return window.location.protocol + '//' + window.location.host;
}
location.domain 这个属性,它已经不在 W3C 的标准推荐列表里,属于历史遗留产物。不要使用,它曾用于同源策略中的父子域互操作,但现在有更规范的 postMessage 方案可以替代。
关于location的常见安全限制
浏览器对 location 有严格的同源限制。你无法通过 location 读取到 iframe 里跨域页面的域名,或者更准确地说,读取跨源 iframe 的 location.href 会抛出 SecurityError 异常,这是浏览器安全模型的底线,不是 bug,如果确实需要获取 iframe 内的域名信息,只能依赖 iframe 内部主动向父页面发送 postMessage。
同时建议避免在 console 里直接复制执行带敏感信息的 URL 拼接代码,尤其是涉及 token 拼接时。location.href 泄露到第三方日志平台,等于把访问路径暴露出去,规范操作是把环境配置独立成一个模块,只暴露必要的取值接口。
最容易踩坑的location域名处理细节
端口为空字符串时的判断陷阱
当页面跑在 80 端口时,location.port 返回的是空字符串而不是 '80',这会导致你写 if (location.port === '80') 时永远不成立,合理的判断逻辑应该是:
// 如果端口为空,则视为默认端口 const port = window.location.port || (window.location.protocol === 'https:' ? '443' : '80');
URL中存在用户名密码时如何取域名
不常见,但确实存在:https://admin:password@example.com/path,这种 URL 里 location.hostname 依然返回 example.com,安全信息已经被浏览器解析,不会出现在 location 属性中。因此不用担心域名提取被用户名密码干扰。
关于默认端口对host返回值的影响
location.host 在端口为默认值时会省略端口号,这意味着即使 URL 是 https://example.com:443/path,location.host 返回的依然是 example.com,而不是 example.com:443。这种省略是浏览器自动处理的,你知道这个规则就能预判返回值,不至于写出依赖异常行为的代码。
把域名信息当作可配置的变量,而不是全局写死的常量。判断域名用 hostname,拼接请求前缀用 origin,关心完整跳转用 href,三者各司其职,就能在绝大多数场景下拿到准确结果。
Q&A:关于location获取当前页面域名的高频问题
如何快速查看当前页面的域名信息?
打开浏览器开发者工具(F12),在 Console 面板输入 `location.hostname` 回车即可看到纯域名,输入 `location.origin` 可看到协议、域名、端口完整前缀。
为什么location.hostname获取到的值没有端口号?
这是规范设计的职责分工,`hostname` 只负责主机名部分,端口号由 `port` 属性单独管理,如果需要带端口的完整主机描述,需要读取 `host` 属性。
获取当前页面的域名后怎么判断是不是本地环境?
判断 `hostname` 是否等于 `localhost` 或 `127.0.0.1` 即可,有些场景下 `0.0.0.0` 也需要视为本地环境,可以根据云函数的本地模拟器地址动态补充判断条件。