支付宝小程序跳转第三方H5页面

• 基础API跳转
• • web-view
  • my.ap.openURL
  • web-view 和 my.ap.openURL 两者比较
  • my.ap.navigateToAlipayPage
• JSAPI跳转
• • 注意点
• startApp
• 总结

基础API跳转

web-view

支付宝小程序想要跳转H5页面，之前只用过 web-view，内嵌H5，这种方式需要配置域名白名单，并且在外链域名的根目录放置校验文件，H5不是自有页面的话，就不能这样去实现。

 <web-view    class="lazy" data-src="https://render.alipay.com/p/s/web-view/index"    onMessage="onmessage"> web-view>

my.ap.openURL

相对于 web-view，还有一种跳转H5的方式， my.ap.openURL，不需要配置域名，但是非支付宝官网页面只有部分符合开放类目的小程序可以使用，且需要到开放平台配置 openURL 白名单。已知目标页面的 URL 或 scheme，可以使用 my.ap.openURL。
跳转到支付宝官方 H5 页面是不需要配置白名单的。

• https://render.alipay.com/p/ 开头的 URL。
• https://ds.alipay.com/?scheme= 开头的 URL。

my.ap.openURL({  // 请将 url 替换为后台加白过的跳转地址  url: 'https://please.replace.me/page',  success: (res) => console.log('openURL success'),  fail: (err) => my.alert({ title: 'openURL fail: ' + JSON.stringify(err) })});

web-view 和 my.ap.openURL 两者比较

两者都有不同的权限要求，下面是从文档拷过来的优劣对比表格，可以对照着选用合适的方式。

my.ap.navigateToAlipayPage

my.ap.navigateToAlipayPage 是用于跳转到支付宝官方业务或运营活动页面的 API。这里利用不需要配置白名单的域名和scheme语法可以实现跳转。

// 支付宝客户端的标准scheme为：alipays://platformapi/startapp?appId=H5App自身的appId// 但如果是某些运营页之类的单独页面，没有自己的appId，// 可以使用Nebula容器的通用浏览器模式appId=20000067 来启动，// 同时将需要打开的H5页面url经过encode编码后设置到url参数内const url = 'https://www.baidu.com';// https://render.alipay.com/p/ 不需要配置白名单// 开了个后门，在不需要配置白名单的链接后面拼上自己的链接const link = 'https://render.alipay.com/p/s/i/?scheme=' + encodeURIComponent('alipays://platformapi/startapp?appId=20000067&url=' + encodeURIComponent(url));my.ap.navigateToAlipayPage({  path: link});

JSAPI跳转

JSAPI 是支付宝钱包提供的丰富的原生API功能，开发者可以使用它们方便调用支付宝提供的各种能力，达到媲美原生应用的体验，如页面跳转，支付功能等。
其中有一个跳转页面的API，pushWindow，用来打开一个新的页面，系统自带转场动画。

注意点

• scheme 跳转请尽量使用 location.href 而不是 pushWindow。用 schema 的方式打开页面已经禁止使用，仅用于向下兼容老业务。
• 与 location.href 的区别，pushWindow 类同于 PC 浏览器的新开标签页，每个 window 都是一个新的标签页，因此原页面仅仅是被压到后台，状态始终保持，JS 也会继续运行。location.href 则是在当前标签页直接跳转。

JSAPI是给H5使用的，而不是支付宝小程序。
现有的功能代码这样使用，应该是因为白名单限制，基础API中的前两种方式都不适合，才被迫使用JSAPI和禁止使用的scheme的。navigateToAlipayPage 是最近新发的文章里才看到可以支持支付宝小程序跳转H5连接（无需添加白名单） 。但是 navigateToAlipayPage 也已经不维护，而是用 openURL 替代。

my.call('pushWindow', {  url: `alipays://platformapi/startapp?appId=20000067&url=${encodeURIComponent(   'https://xxxx')}`});

在小程序直接使用https链接会导致页面访问受限，无法打开，用scheme的方式可以跳过限制。但是不应该这么做，只是单纯的记录一下有这种操作。

startApp

需要申请startApp权限，可以跳转任意URL

my.call('startApp', {  appId: '20000067',  param: {    url: 'https://xxx'  }});

总结

综上，跳转方式需具体情况具体分析，选择能力范围内最适合的方式，尽量不要选择禁用和停止维护的方法。这里不讨论支付宝官方页面，对自己人并没有太多限制。

扩展: 小程序scheme链接介绍

来源地址：https://blog.csdn.net/stupid_muscleman/article/details/128640722