用户工具

站点工具


mina:api_interface

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版
前一修订版
mina:api_interface [2020/08/22 15:51] – [媒体] sabertoymina:api_interface [未知日期] (当前版本) – 外部编辑 (未知日期) 127.0.0.1
行 1: 行 1:
 ====== 6.API 接口 ====== ====== 6.API 接口 ======
 +
 +[[https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html|微信开放文档API]]
 +
 +===== -#1 类型 =====
 +
 +==== - 事件监听 API ====
 +
 +以<wrap em> on</wrap> 开头的 API 用来监听某个事件是否触发,如:wx.onSocketOpen,wx.onCompassChange 等。
 +
 +接受一个<wrap hi>回调函数</wrap>作为参数,当事件触发时会调用这个回调函数,并将相关数据以参数形式传入。
 +
 +<code javascript>
 +wx.onCompassChange(function (res) {
 +  console.log(res.direction)
 +})
 +</code> 
 +
 +==== - 同步 API ====
 +
 +以 Sync 结尾的 API 都是同步 API, 如 wx.setStorageSync,wx.getSystemInfoSync 等。
 +
 +同步 API 的执行结果可以通过函数返回值直接获取,如果执行出错会抛出异常。
 +
 +<code javascript>
 +try {
 +  wx.setStorageSync('key', 'value')
 +} catch (e) {
 +  console.error(e)
 +}
 +</code> 
 +
 +==== - 异步 API ====
 +
 +大多数 API 都是异步 API,如 wx.request,wx.login 等。这类 API 接口通常都接受一个 Object 类型的参数。
 +
 +[[https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/api.html#API|Object 参数说明]]
 +
 +[[https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/api.html#API|回调函数的参数]]
 +
 +success,fail,complete 函数调用时会传入一个 Object 类型参数
 +
 +==== - 异步API返回Promise ====
 +
 +异步 API 支持 callback & promise 两种调用方式。
 +
 +<code javascript>
 +// callback 形式调用
 +wx.chooseImage({
 +  success(res) {
 +    console.log('res:', res)
 +  }
 +})
 +</code>
 +
 +<code javascript>
 +// promise 形式调用
 +wx.chooseImage().then(res => console.log('res: ', res))
 +</code>
  
 ===== API发起请求 wx.request ===== ===== API发起请求 wx.request =====
mina/api_interface.1598082700.txt.gz · 最后更改: 2020/08/22 15:51 由 sabertoy