快速开始

智能小程序提供了自动化 SDK，旨在为开发者提供对小程序进行自动化测试的能力。

主要功能

智能小程序自动化 SDK 主要包含以下功能：

  • 可以控制小程序跳转到指定页面
  • 可以获取小程序页面数据
  • 可以获取小程序页面元素信息
  • 可以调用 swan 对象上任意接口
  • …

运行环境

  • 安装 Node.js 并且版本大于 8.0
  • 基础库版本为 3.40.0 及以上
  • 开发者工具 版本为 2.22.0 及以上
  • 开发者工具已登录且具有项目 appid 的开发权限（也可选择使用测试号）

安装

使用智能小程序自动化 SDK，直接执行以下命令：

  1. npm i swan-automator --save-dev

使用

引入 SDK 编写控制脚本，参考以下示例：

  1. const automator = require('swan-automator');
  3. (async () => {
  4.     const smartProgram = await automator.launch({
  5.         cliPath: 'path/to/cli',
  6.         projectPath: 'path/to/project'
  7.     });
  9.     const page = await smartProgram.reLaunch('/pages/component/component');
  10.     await page.waitFor(500);
  11.     const element = await page.$('.item');
  12.     console.log(await element.attribute('class'));
  13.     await element.tap();
  14.     await page.waitFor(200);
  15.     console.log(await element.attribute('class'));
  17.     await smartProgram.close();
  18. })();

最后执行 node path/to/script 即可看到输出结果。

关于 SDK 提供的接口，更多详细用法可以参考 Automator、SmartProgram、Page、Element。