微信小程序开发文档 第85页

小程序·云开发提供了丰富的数据库操作 API，此处是数据库小程序端的 API 参考文档。 数据库 API 都是懒执行的，这意味着只有真实需要网络请求的 API 调用才会发起网络请求，其余如获取数据库、集合、记录的引用、在集合上构造查询条件等都是不会触发网络请求的。触发网络请求的 API 有如下几个： API 说明 get 获取集合 / 记录数据 add 在集合上新增记录 update 更新集合 / 记录数据 set 替换更新一个记录 remove 删除记录 count 统计查询语句对应的记录条数 获取引用的 API 有如下几个： API 说明 database 获取数据库引用，返回 Database 对象 collection 获取集合引用，返回 Collection 对象 doc 获取对一个记录的引用，返回 Document 对象 在数据库 (Database) 对象上有如下字段： 字段 说明 command 获取数据库查询及更新指令，返回 Command serverDate 构造服务端时间 Geo 获取地理位置操作对象，返回 Geo 对象 在集合 (Collection) 对象上有如下 API： API 说明 doc 获取对一个记录的引用，返回 Document 对象 add 在集合上新增记录 where 构建一个在当前集合上的查询条件，返回 Query，查询条件中可使用查询指令 orderBy 指定查询数据的排序方式 limit 指定返回数据的数量上限 skip 指定查询时从命中的记录列表中的第几项之后开始返回 field 指定返回结果中每条记录应包含的字段 在记录 (Document) 对象上有如下 API： API 说明 get 获取记录数据 update 局部更新数据 set 替换更新记录 remove 删除记录 field 指定返回结果中记录应包含的字段 Command (db.command) 对象上有如下查询指令： API 说明 eq 字段是否等于指定值 neq 字段是否不等于指定值 lt 字段是否小于指定值 lte 字段是否小于或等于指定值 gt 字段是否大于指定值 gte 字段是否大于或等于指定值 in 字段值是否在指定数组中 nin 字段值是否不在指定数组中 and 条件与，表示需同时满足另一个条件 or 条件或，表示如果满足另一个条件也匹配 Command (db.command) 对象上有如下更新指令： API 说明 set 设置字段为指定值...

小程序·云开发提供了丰富的数据库操作 API，此处是数据库 Server 端的 API 参考文档，可用于云函数运行环境。 Server 端的 API 与小程序端基本保持一致，有如下不同： Server API 不再接受回调（success, fail, complete），统一返回 Promise Server 端有批量写和批量删除的权限，即可在集合或查询语句上调用 update 或 remove Server 端独有 API 如创建集合（db.createCollection） 数据库 API 都是懒执行的，这意味着只有真实需要网络请求的 API 调用才会发起网络请求，其余如获取数据库、集合、记录的引用、在集合上构造查询条件等都是不会触发网络请求的。触发网络请求的 API 有如下几个： API 说明 get 获取集合 / 记录数据 add 在集合上新增记录 update 更新集合 / 记录数据 set 替换更新一个记录 remove 删除记录 count 统计查询语句对应的记录条数 获取引用的 API 有如下几个： API 说明 database 获取数据库引用，返回 Database 对象 collection 获取集合引用，返回 Collection 对象 doc 获取对一个记录的引用，返回 Document 对象 在数据库 (Database) 对象上有如下字段： 字段 说明 command 获取数据库查询及更新指令，返回 Command serverDate 构造服务端时间 Geo 获取地理位置操作对象，返回 Geo 对象 createCollection 创建一个集合 在集合 (Collection) 对象上有如下 API： API 说明 doc 获取对一个记录的引用，返回 Document 对象 add 在集合上新增记录 update 更新数据 where 构建一个在当前集合上的查询条件，返回 Query，查询条件中可使用查询指令 remove 删除匹配相应筛选条件的记录 orderBy 指定查询数据的排序方式 limit 指定返回数据的数量上限 skip 指定查询时从命中的记录列表中的第几项之后开始返回 field 指定返回结果中每条记录应包含的字段 在记录 (Document) 对象上有如下 API： API 说明 get 获取记录数据 update 局部更新数据 set 替换更新记录 remove 删除记录 field 指定返回结果中记录应包含的字段 Command (db.command) 对象上有如下查询指令： API 说明 eq 字段是否等于指定值 neq 字段是否不等于指定值 lt 字段是否小于指定值...

remove 小程序端只可删除单条记录，如果需删除多条记录，需使用云函数端 API 删除单条记录

update 即可更新单条记录，也可更新多条记录 更新单条记录 更新多条记录

get 在集合和记录上都有 get 方法： Collection.get Document.get

db.command 获取数据库查询及更新指令，列表见 API 列表中的 command 列表。 示例代码 const _ = db.command

云开发控制台 云开发提供了一个控制台用于可视化管理云资源。控制台包含以下几大模块。 概览：查看云资源的总体使用情况 用户管理：查看小程序的用户访问记录 数据库：管理数据库集合、记录、权限设置、索引设置 存储管理：管理云文件、权限设置 云函数：管理云函数、查看调用日志、监控记录 统计分析：查看云资源详细使用统计 在用户管理中会显示使用云能力的小程序的访问用户列表，默认以访问时间倒叙排列，访问时间的触发点是在小程序端调用 wx.cloud.init 方法，且其中的 traceUser 参数传值为 true。例： wx.cloud.init({ traceUser: true })

快捷键 本节介绍一些快捷键的使用。 Mac OS 快捷键 Windows 快捷键 说明 ⌘ + Q 退出开发者工具 ⇧ + ⌘ + N shift + ctrl + N 新建项目 ⇧ + ⌘ + W shift + ctrl + W 关闭当前项目 文件 ⌘ + N ctrl + N 新建文件 ⌘ + S ctrl + S 保存文件 ⇧ + ⌘ + S shift + ctrl + S 保存所有文件 ⌘ + W ctrl + W 关闭当前文件 编辑 ⌘ + Z ctrl + Z 撤销 ⇧ + ⌘ + Z shift + ctrl + Z 重做 ⌘ + C ctrl + C 复制 ⌘ + X ctrl + X 剪切 ⌘ + V ctrl + V 粘贴 ⌘ + [ ctrl + [ 代码左缩进 ⌘ + ] ctrl + ]...

API 框架提供丰富的微信原生API，可以方便的调起微信提供的能力，如获取用户信息，本地存储，支付功能等。 说明： wx.on开头的API是监听某个事件发生的API接口，接受一个CALLBACK函数作为参数。当该事件触发时，会调用CALLBACK函数。 如未特殊约定，其他API接口都接受一个OBJECT作为参数。 OBJECT中可以指定success,fail,complete来接收接口调用结果。 参数名 类型 必填 说明 success Function 否 接口调用成功的回调函数 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） API列表： 网络API列表： API 说明 wx.request 发起网络请求 wx.uploadFile 上传文件 wx.downloadFile 下载文件 wx.connectSocket 创建WebSocket连接 wx.onSocketOpen 监听WebSocket打开 wx.onSocketError 监听WebSocket错误 wx.sendSocketMessage 发送WebSocket消息 wx.onSocketMessage 接受WebSocket消息 wx.closeSocket 关闭WebSocket连接 wx.onSocketClose 监听WebSocket关闭 媒体API列表： API 说明 wx.chooseImage 从相册选择图片，或者拍照 wx.previewImage 预览图片 wx.startRecord 开始录音 wx.stopRecord 结束录音 wx.playVoice 播放语音 wx.pauseVoice 暂停播放语音 wx.stopVoice 结束播放语音 wx.getBackgroundAudioPlayerState 获取音乐播放状态 wx.playBackgroundAudio 播放音乐 wx.pauseBackgroundAudio 暂停播放音乐 wx.seekBackgroundAudio 控制音乐播放进度 wx.stopBackgroundAudio 停止播放音乐 wx.onBackgroundAudioPlay 监听音乐开始播放 wx.onBackgroundAudioPause 监听音乐暂停 wx.onBackgroundAudioStop 监听音乐结束 wx.chooseVideo 从相册选择视频，或者拍摄 文件 API 列表： API 说明 wx.saveFile 保存文件 wx.getSavedFileList 获取已保存的文件列表 wx.getSavedFileInfo 获取已保存的文件信息 wx.removeSavedFile 删除已保存的文件信息 wx.openDocument 打开文件 数据 API 列表： API 说明 wx.getStorage 获取本地数据缓存 wx.getStorageSync 获取本地数据缓存 wx.setStorage 设置本地数据缓存 wx.setStorageSync 设置本地数据缓存 wx.getStorageInfo 获取本地缓存的相关信息 wx.getStorageInfoSync 获取本地缓存的相关信息 wx.removeStorage 删除本地缓存内容 wx.removeStorageSync 删除本地缓存内容 wx.clearStorage 清理本地数据缓存 wx.clearStorageSync...

onPullDownRefresh 在 Page 中定义 onPullDownRefresh 处理函数，监听该页面用户下拉刷新事件。 需要在config的window选项中开启enablePullDownRefresh。 当处理完数据刷新后，wx.stopPullDownRefresh可以停止当前页面的下拉刷新。 wx.startPullDownRefresh(OBJECT) 基础库 1.5.0 开始支持，低版本需做兼容处理 开始下拉刷新，调用后触发下拉刷新动画，效果与用户手动下拉刷新一致 Object参数说明： 参数 类型 必填 说明 success Function 否 接口调用成功的回调函数 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） success返回参数说明： 参数名 类型 说明 errMsg String 接口调用结果 示例代码： wx.startPullDownRefresh() wx.stopPullDownRefresh() 停止当前页面下拉刷新。 示例代码： Page({ onPullDownRefresh: function(){ wx.stopPullDownRefresh() } })