实现跳转外部浏览器打开外部 URL

最近更新时间:2024-11-26 16:04:13

我的收藏

功能介绍

使用场景

在既有业务流程中,出现业务方需要用外部浏览器打开外部的 URL的情况,如通过浏览器实现下载文件、打开固定的业务信息界面等。

交互效果

使用此方法时,浏览器打开可信域名的 URL 时,将会向用户弹框来获取用户的许可,界面如下:

管理后台配置页面





用户弹框页面





实现方案

步骤一:配置 H5 可信域名

应用管理后台 > 安全配置 > H5 可信域名,添加应用需要访问的 URL 的可信域名。

步骤二:调用相关 JSAPI 进行网页开启

接口:ui.openExternalPage
描述:跳转外部浏览器打开设置的 URL。
支持的客户端:iOS、Android、Windows、Mac。
支持版本:3.13.0及以上版本。
是否需要鉴权:需要鉴权

代码示例

wemeet.ui.openExternalPage({
url: 'https://xxxxxxxx',
success: () => {
console.log('openExternalPage success');
},
fail: (err) => {
console.log('openExternalPage canceled', err);
}
})
.catch(err => {
console.error('openExternalPage error');
})

输入参数

OpenUrlParam 参数

参数名称
参数类型
参数描述
url
String
需要在 WebView 打开的外部网页的URL,只支持 HTTPS 协议。
success
-
打开网页成功回调函数。
fail
-
打开网页失败回调函数。

错误码

错误码
说明
10
参数错误。
2006、2007
应用已下架。
2011
跳转链接只支持 HTTPS 协议。
2009
跳转链接不合法,仅支持可信域名内的链接。
20
服务异常。