位置:电子教程 > 微信小程序入门教程 (如果看不到内容请使用360浏览器) 推荐学习资源
小程序起步
小程序基础知识
小程序基础语法
当前阅读教程:微信小程序入门教程 > API
阅读(22555525)      收藏       赞(5685)      分享
上一篇: 模块化 下一篇: 视图层WXML

小程序开发框架提供丰富的微信原生 API,可以方便地调用微信提供的能力,如获取用户信息、本地存储、支付功能等。通常,在小程序 API 有以下几种类型:事件监听 API、同步API、异步API

1.事件监听 API

on 开头的 API 用来监听某个事件是否触发,如:wx.onSocketOpenwx.onCompassChange 等。这类 API 接受一个回调函数作为参数,当事件触发时会调用这个回调函数,并将相关数据以参数形式传入。代码示例

小白教程网www.2d5.net

如下:

wx.onCompassChange(function (res) {

  console.log(res.direction)

})

2.同步 API

Sync 结尾的 API 都是同步 API wx.setStorageSyncwx.getSystemInfoSync 等。此外,也有一些其他的同步 API,如 wx.createWorkerwx.getBackgroundAudioManager 等。同步 API 的执行结果可以通过函数返回值直接获取,如果执行出错会抛出异常。代码示例

小白教程网www.2d5.net

如下:

try {

  wx.setStorageSync('key', 'value')

} catch (e) {

  console.error(e)

}

3.异步 API

大多数 API 都是异步 API,如 wx.requestwx.login 等。这类 API 接口通常都接受一个 Object 类型的参数,这个参数用于指定如何接收接口调用结果。

Object 参数说明如下:

参数名

类型

必填

说明

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数(调用成功、失败都会执行)

其他

Any

-

接口定义的其他参数

API通常的回调函数有三个:successfailcomplete,回调函数调用时会传入一个 Object 类型参数,包含以下字段:

属性

类型

说明

errMsg

string

错误信息,如果调用成功返回 ${apiName}:ok

errCode

number

错误码,仅部分 API 支持,具体含义请参考对应   API 文档小白教程网,成功时为 0

其他

Any

接口返回的其他数据

异步 API 的执行结果需要通过 Object 类型的参数中传入的对应回调函数获取。部分异步 API 也会有返回值,可以用来实现更丰富的功能,如 wx.requestwx.connectSockets 等。

代码示例

小白教程网www.2d5.net

如下:

wx.login({

  success(res) {

    console.log(res.code)

  }

})



上一篇: 模块化 下一篇: 视图层WXML
毕业设计网             广告联系QQ:45157718(微信同号)