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)

参数说明:

参数说明
urlstring,可选。要解析的 URL 地址,不传默认取 window.location.href
keystring,必填。要获取的参数名

示例代码:

// 当前地址:https://xxx.com/page?id=100&name=test
var params = McrbHttpClient.urlHelper.getUrlParam();
// 输出结果:{ id: '100', name: 'test' }

var id = McrbHttpClient.urlHelper.getParam('id');
// 输出结果:100

var 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)

参数说明:

参数说明
urlstring,基础 URL
paramsObject,要追加的参数对象

示例代码:

// 基础追加
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 参数说明:

配置项类型默认值说明
targetString'_self'跳转方式。'_self' 当前页跳转;'_blank' 新窗口打开(可直接传字符串简写,如 navTo(url, params, '_blank'))
featuresString''新窗口特性,如 '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,防止新窗口篡改源页面数据。
本文档来自—microbee-http 丨 软件开发框架平台