2023年7月2日发(作者：)

微信⼩程序内嵌⽹页web-view

web-view 组件是⼀个可以⽤来承载⽹页的容器，会⾃动铺满整个⼩程序页⾯。个⼈类型与海外类型的⼩程序暂不⽀持使⽤。客户端 6.7.2 版本开始， 对 组件⽆效属性名类型默认值

说明srcStringwebview 指向⽹页的链接。可打开关联的公众号的⽂章，其它⽹页需登录配置业务域名。⽹页向⼩程序 postMessage 时，会在特定时机（⼩程序后退、组件销毁、分享）触发并收到消息。 ={ data }⽹页加载成功时候触发此事件。 = { src }⽹页加载失败的时候触发此事件。 = { src }bindmessageEventHandler

bindloadbinderrorEventHandlerEventHandler

⽰例代码：相关接⼝ 1⽹页中可使⽤提供的接⼝返回⼩程序页⾯。 ⽀持的接⼝有：接⼝名说明参数与⼩程序接⼝⼀致参数与⼩程序接⼝⼀致参数与⼩程序接⼝⼀致参数与⼩程序接⼝⼀致参数与⼩程序接⼝⼀致向⼩程序发送消息获取当前环境最低版本⽰例代码：// teTo({url: '/path/to/page'})ssage({ data: 'foo' })ssage({ data: {foo: 'bar'} })(function(res) { (ogram) // true })相关接⼝ 2⽹页中仅⽀持以下JSSDK接⼝：接⼝模块判断客户端是否⽀持js图像接⼝

⾳频接⼝

智能接⼝设备信息地理位置

摇⼀摇周边

微信扫⼀扫微信卡券

长按识别接⼝说明

拍照或上传预览图⽚上传图⽚下载图⽚获取本地图⽚开始录⾳停⽌录⾳监听录⾳⾃动停⽌播放语⾳暂停播放停⽌播放监听语⾳播放完毕上传接⼝下载接⼝识别⾳频获取⽹络状态使⽤内置地图获取地理位置开启ibeacon关闭ibeacon监听ibeacon调起微信扫⼀扫拉取使⽤卡券列表批量添加卡券接⼝查看微信卡包的卡券⼩程序圆形码具体接⼝checkJSApichooseImagepreviewImageuploadImagedownloadImagegetLocalImgDatastartRecordstopRecordonVoiceRecordEndplayVoicepauseVoicestopVoiceonVoicePlayEnduploadVoicedownloadVoicetranslateVoicegetNetworkTypegetLocationopenLocationstartSearchBeaconsstopSearchBeaconsonSearchBeaconsscanQRCodechooseCardaddCardopenCard⽆相关接⼝ 3⽤户分享时可获取当前的URL，即在onShareAppMessage回调中返回webViewUrl参数。⽰例代码：Page({ onShareAppMessage(options) { (wUrl) }})相关接⼝ 4在⽹页内可通过window.__wxjs_environment变量判断是否在⼩程序环境，建议在WeixinJSBridgeReady回调中使⽤，也可以使⽤提供的getEnv接⼝。⽰例代码：// web-view下的页⾯内function ready() { (window.__wxjs_environment === 'miniprogram') // true}if (!JSBridge || !) { ntListener('WeixinJSBridgeReady', ready, false)} else { ready()}// 或者(function(res) { (ogram) // true})Bug & Tip1. ⽹页内iframe的域名也需要配置到域名⽩名单。2. 开发者⼯具上，可以在 组件上通过右键 - 调试，打开 组件的调试。3. 每个页⾯只能有⼀个，会⾃动铺满整个页⾯，并覆盖其他组件。4. ⽹页与⼩程序之间不⽀持除JSSDK提供的接⼝之外的通信。5. 在iOS中，若存在JSSDK接⼝调⽤⽆响应的情况，可在的src后⾯加个#wechat_redirect解决。

常见错误：1. 打开的域名没有在⼩程序管理后台设置业务域名（注意是业务域名，不是服务器域名）2. 打开的页⾯必须为https服务3. 打开的页⾯302过去的地址也必须设置过业务域名4. web-view空⽩问题，请升级微信客户端到 6.5.165. 页⾯可以包含iframe，但是iframe的地址必须为业务域名6. web-view不⽀持⽀付能⼒，web-view的API能⼒见web-view的⽂档说明7. 开发者⾃⼰检查⾃⼰的https服务是否正常，测试⽅法：普通浏览器打开对应的地址8.

关于web-view的问题，⼤家可以集中在这个帖⼦留⾔，为了保证⾼效查问题，请提供以下信息：1. web-view的src地址2. 后台配置的业务域名是否设置成功3. 微信的版本4. 遇到问题的⼩程序APPID以及复现的微信号5. 出问题的错误提⽰信息是什么6. 后台设置失败问题，请提供⼩程序APPID以及遇到问题的时间点。