微信提供的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