URL 参数与跳转工具
功能介绍:
统一处理 URL 参数读取、安全拼接、判断参数是否存在、路由安全跳转等场景;
自动处理 ? 和 & 的拼接,避免出现 ?a=1?b=2 或 && 的低级错误;
同名参数自动覆盖,防止参数重复;精准匹配参数名,避免正则误伤;
跳转支持当前页和新窗口打开,且具备新窗口被拦截时的自动降级兜底机制。
McrbHttpClient.urlHelper
1. 获取参数
// 获取 URL 上所有参数键值对(不传 url 默认取当前页面地址)
McrbHttpClient.urlHelper.getUrlParam(url)// 获取 URL 上指定参数值
McrbHttpClient.urlHelper.getParam(key, url)// 获取菜单高亮参数值(自动兼容 menuid / menuId / menu_id)
McrbHttpClient.urlHelper.getMenuChecked(url)
参数说明:
| 参数 | 说明 |
| url | string,可选。要解析的 URL 地址,不传默认取 window.location.href |
| key | string,必填。要获取的参数名 |
示例代码:
// 当前地址:https://xxx.com/page?id=100&name=test
var params = McrbHttpClient.urlHelper.getUrlParam();
// 输出结果:{ id: '100', name: 'test' }var id = McrbHttpClient.urlHelper.getParam('id');
// 输出结果:100var menuId = McrbHttpClient.urlHelper.getMenuChecked();
// 输出结果:自动获取 menuid、menuId 或 menu_id 的值
2. 判断参数
// 判断 URL 是否包含某参数(精准匹配,替代正则 /menuid/.test(url))
McrbHttpClient.urlHelper.checkUrlParam(url, key)
示例代码:
var url = '/auto/list.html?menuid=12';
McrbHttpClient.urlHelper.checkUrlParam(url, 'menuid');
// 输出结果:true// 精准匹配,不会误伤(正则写法会错误匹配到 xmenuid)
McrbHttpClient.urlHelper.checkUrlParam('/auto/list.html?xmenuid=12', 'menuid');
// 输出结果:false
3. 拼接参数
// 向 URL 追加参数并返回新的 URL 字符串
McrbHttpClient.urlHelper.appendQuery(url, params)
参数说明:
| 参数 | 说明 |
| url | string,基础 URL |
| params | Object,要追加的参数对象 |
示例代码:
// 基础追加
McrbHttpClient.urlHelper.appendQuery('/auto/list.html?menuid=12', { id: 100, lev1: 1 });
// 输出结果:/auto/list.html?menuid=12&id=100&lev1=1// 同名覆盖(替换原有的 menuid)
McrbHttpClient.urlHelper.appendQuery('/auto/list.html?menuid=12', { menuid: 99 });
// 输出结果:/auto/list.html?menuid=99// 数组参数展开
McrbHttpClient.urlHelper.appendQuery('/auto/list.html', { ids: [1, 2] });
// 输出结果:/auto/list.html?ids=1&ids=2
4. 路由跳转
// 安全跳转,自动拼接参数
McrbHttpClient.urlHelper.navTo(url, params, options)// 语义化新窗口打开快捷方法,等价于 navTo(url, params, '_blank')
McrbHttpClient.urlHelper.openBlank(url, params, features)
options 参数说明:
| 配置项 | 类型 | 默认值 | 说明 |
| target | String | '_self' | 跳转方式。'_self' 当前页跳转;'_blank' 新窗口打开(可直接传字符串简写,如 navTo(url, params, '_blank')) |
| features | String | '' | 新窗口特性,如 'width=1200,height=800' |
示例代码:
// 1. 当前页跳转
McrbHttpClient.urlHelper.navTo('/auto/edit.html', { id: 100, menuid: 12 });// 2. 新窗口打开(简写)
McrbHttpClient.urlHelper.navTo('/auto/view.html', { id: 100 }, '_blank');// 3. 新窗口打开(配置项写法)
McrbHttpClient.urlHelper.navTo('/auto/view.html', { id: 100 }, {
target: '_blank',
features: 'width=1200,height=800'
});// 4. 语义化调用
McrbHttpClient.urlHelper.openBlank('/auto/view.html', {
id: 100,
menuid: McrbHttpClient.urlHelper.getMenuChecked()
});
注意事项:
| 安全拦截 | navTo 的 _blank 模式底层依赖 window.open,若在异步回调(如 setTimeout、Ajax)中调用可能被浏览器拦截。被拦截时,urlHelper 内部会自动降级为当前页跳转(location.href),确保业务不中断。 |
| 参数编码 | appendQuery 内部已经使用了 encodeURIComponent 进行编码,请勿在传入前手动编码,以免双重编码。 |
| 安全隔离 | 使用 navTo 打开新窗口后,代码会自动将 win.opener = null,防止新窗口篡改源页面数据。 |
扫一扫