微信提供的JS-SDK wx.config/ready/error处理函数注意事项

简介

微信 JSSDK是微信公众号开发中的一个JavaScript工具包,提供了许多方便的接口和方法,方便开发者在微信公众平台上开发出更加丰富和互动的应用程序。通过微信JSSDK,开发者可以实现一系列基于微信公众号的功能,例如:分享到朋友圈、分享到对话、调起微信支付、获取地理位置等等。微信JSSDK可以用于微信公众号、微信小程序等平台的开发。

如果要使用微信提供的JS-SDK,其中一步是使用wx.config来注入配置信息来进行权限验证

但是wx.config是一个客户端的异步操作,如果需要在页面加载时就调用相关接口,就必须确保wx.config权限验证完毕后再调用接口。

wx.config({
    
    
  debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
  appId: '', // 必填,公众号的唯一标识
  timestamp: , // 必填,生成签名的时间戳
  nonceStr: '', // 必填,生成签名的随机串
  signature: '',// 必填,签名
  jsApiList: [] // 必填,需要使用的JS接口列表
});

通过ready接口处理成功验证

wx.ready(function(){
    
    
  // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});

通过error接口处理失败验证

wx.error(function(res){
    
    
  // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
});

重要说明

微信提供了wx.ready函数,虽然文档上说wx.ready是验证成功时执行的函数,但权限验证成功或失败都会调用。

也就是说如果权限验证通过,只会调用wx.ready函数,如果权限验证失败,先调用wx.error函数,然后再调用wx.ready

所以在wx.ready里调用接口也不保险,我们需要在真正验证时才调用接口。

参阅资料:

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html

猜你喜欢

转载自blog.csdn.net/m0_37680500/article/details/131568874