【小程序开发笔记】小程序API入门

小程序API入门

1.1 API类型

1. 事件监听API。以on开头的API用来监听某个事件是否触发。可接受一个回调函数作为参数。
2. 同步API。以Sync结尾的API都是同步API。同步API执行结果可通过返回值直接获取，如果执行出错会报错

3. 异步API。大多数API都是异步API。这类接口通常都接受Object类型的参数

   异步API 语法格式： api名称({ api内容 })
   api内容包括三部分回调函数: success、fail、complete

4. API运行顺序：
   

例:

wx.login({
    success(res){ // API调用成功执行的代码},
    fail(res){ // API调用失败执行的代码},
    complete(res){ // API调用完毕执行的代码}
})

这里的res参数为Object类型参数，包含

errMsg: string类型，错误信息，如果调用成功返回ok
errCode: number类型，错误码，部分API支持，成功返回0
接口返回的其他数据。

1.2 页面路由

1. wx.reLauch() :关闭所有页面(其他页面都将被卸载)，打开到应用的某个页面(该页面重新加载)。
2. wx.redictTo() :关闭(卸载)当前页面，跳转到某个应用内的页面。
3. wx.navigateTo() :保留(不卸载)当前页面，跳转到某个应用内的页面。
4. wx.navigateBack() :关闭当前页面，返回上一页面，或多级页面。

再次提醒： API内无法使用this，需要在调用API之前保存this进行使用。如: var that = this

1.3 用户授权

 checkUserInfo: function(){
    // 获取小程序当前参数的API
    wx.getSetting({
      success(res){
        // 检查有用户是否已经授权
        if(res.authSetting["scope.userInfo"]){
            // 获取用户信息
            wx.getUserInfo({
              success(res2){
                console.log(res2.userInfo)
              }
            })
        }
      }
    })
  }

userInfo 包括以下字段:

1. nickName ：昵称
2. avatarUrl: 用户头像图片的URL
3. gender
4. coutry
5. province
6. city
7. language