小程序测试方案初探

作者:邹世杰

前言

2017年1月9号微信小程序正式上线,小程序不需要安装就能使用,依托微信强大的生态环境,能做到很多H5所不能做的事情。从微信小程序发布这段时间,陆陆续续开发了不少小程序相关的项目,总结了一些通用性的组件,但是对于小程序如何做测试,依然是一头雾水,直到做了不少的项目,积累的一些经验和开源库之后才理清如何做测试,下面将会介绍如何对小程序做UI测试和单元测试。

工具的准备

介绍

node

这个应该不用多做介绍了,不过这次demo中要求node版本应该大于7.6.0,因为puppeteer要求最低版本是v6.4.0,但是因为官方示例中大量使用 async/await 等新特性,所以需要使用 v7.6.0 或更高版本的 Node,async/await能让异步回调代码更加简洁,不然整个代码都是promise.then

puppeteer

Chrome 团队出品的一款更友好的Headless Chrome Node API,用于代替用户在页面上面点击、拖拽、输入等多种操作,常见的使用场景还是应用到UI自动化测试,puppeteer可以对页面进行截图保存为图片或者PDF,解决爬虫无法实现的一些操作(异步加载页面内容) 。

类似的工具:

wept

wept可以让小程序脱离开发者工具或者微信客户端直接运行在浏览器上面,后台使用node,提供小程序API的模拟返回(wx.login、wx.getUserInfo等),前端实现了 view 层、service 层和控制层之间的相关通讯逻辑。

mocha

JavaScript测试框架,在浏览器和Node环境都可以使用,通过测试框架,可以为你的JavaScript代码添加相应的测试用例,使得项目代码更加强健。

chai

Chai是一个BDD/TDD模式的断言库,在node和浏览器环境都能运行,API通俗易懂,断言类型和方式丰富,搭配mocha,江湖人戏称为”抹茶“

配置环境

npm i -g wept npm i —save-dev puppeteer mocha chai

在安装puppeteer有可能会出现以下报错

ERROR: Failed to download Chromium r508693! Set "PUPPETEER_SKIP_CHROMIUM_DOWNLOAD" env variable to skip download.
Error: Download failed: server returned code 502. URL: https://storage.googleapis.com/chromium-browser-snapshots/Win_x64/508693/chrome-win32.zip
    at ClientRequest.https.get.response (D:\chromium\node_modules\puppeteer\utils\ChromiumDownloader.js:197:21)
    at Object.onceWrapper (events.js:316:30)
    at emitOne (events.js:115:13)
    at ClientRequest.emit (events.js:210:7)
    at HTTPParser.parserOnIncomingClient [as onIncoming] (_http_client.js:565:21)
    at HTTPParser.parserOnHeadersComplete (_http_common.js:116:23)
    at Socket.socketOnData (_http_client.js:454:20)
    at emitOne (events.js:115:13)
    at Socket.emit (events.js:210:7)
    at ClientRequest.onsocket (D:\chromium\node_modules\https-proxy-agent\index.js:181:14)

其实是因为下载完puppeteer包之后有执行node install.js去下载chromium(实验版chrome),但是由于网络的原因,下载失败了,我们可以避免缺省的下载 chromium,通过设置环境变量来阻止set PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=1

然后手动去下载chromium,上面有给出链接https://storage.googleapis.com/chromium-browser-snapshots/Win_x64/508693/chrome-win32.zip

TODO

直接看官方给出的demo

const puppeteer = require('puppeteer');
(async () => {
  //这里和官方不一样的就是,需要手动指定chromium目录所在的地址(上面链接下载之后解压),headless为true则不会打开chromium
  const browser = await puppeteer.launch({executablePath: '/chromium/chrome.exe',headless: false});

  //相当于新建选项卡
  const page = await browser.newPage();
  //跳转到指定URL
  await page.goto('https://example.com');
  //截图
  await page.screenshot({path: 'example.png'});
  //关闭页面或者选项卡
  await browser.close();
})();

上面几行代码其实就是相当于我们日常的一些操作:打开chrome->新建选项卡->输入url并回车->页面截图->保存,也可以看出puppeteer是站在使用者的角度去设计API。

跑通测试demo之后,来试试小程序这边,首先必须让小程序跑在chrome上面,就要用到wept了。

1. 直接在小程序根目录上面执行wept

然后打开chrome,访问http://localhost:3000/#!pages/index/index ,就可以看到小程序运行在chrome上了,接下来要让puppeteer去抓取小程序里面的内容,直接上代码

const puppeteer = require('puppeteer');
const devices = require('puppeteer/DeviceDescriptors');
(async () => {
        const browser = await puppeteer.launch({executablePath: '/chromium/chrome.exe',headless: true});
        const page = await browser.newPage();
        //设置展示的设备https://github.com/GoogleChrome/puppeteer/blob/master/DeviceDescriptors.js
        await page.emulate(devices['iPhone 6']);
        //多一个参数waitUntil,指跳转之后等待网络空闲之后再执行下一步操作,没有这个的话,截图很有可能是白屏,因为内容还没渲染出来
        await page.goto('http://localhost:3000/#!pages/index/index', {waitUntil: 'networkidle'});
        //小程序的内容其实是放在一个iframe里面,外面是无法直接抓取到iframe里面的内容,所以这里需要获取页面所有的iframe
        const frames = await page.frames();
        //根据iframe的name属性来获取正确的iframe
        const weChatFrame = frames.find(f => f.name() === 'view-0');
        //在上下文环境中获取需要抓取的内容
        const outerText = await weChatFrame.evaluate(() => {
        //上下文执行环境,跟H5一致
            const anchors = Array.from(document.querySelectorAll('.container'));
            return anchors.map(anchor => anchor.textContent);
        });
        console.log('the outerText: ', outerText);
        await browser.close();

})();

直接来看页面执行的效果

这样我们就能拿到小程序的内容,便于我们后续的单元测试,接下来我们可以加入”抹茶”来测试输出是否符合预期,先上代码

const puppeteer = require('puppeteer');
const devices = require('puppeteer/DeviceDescriptors');
const expect = require('chai').expect;
describe('output test', () => {
    it('should return Hello 测试帐号 ', () => {
        (async () => {
            //小程序内容获取代码跟上述一致
            //...
            expect(outerText[0]).to.equal('Hello 测试帐号');
            //...
        })
    })
})

运行效果

结语

小程序其实也有上线一个云测试,但是我觉得有个不好的地方,假如你的小程序是依赖于后台CGI返回数据作为展示,那么你必须先上线CGI才能使用云测试,不够灵活,更希望有一个能自己mock数据来测试不同情况下的小程序的展示。

本篇文章介绍使用wept和puppeteer来对小程序做E2E测试,对于测试环境和正式环境还是有差异的,比如Object.defineProperty小程序是不支持这个API的,但是测试环境是可以跑通的,当然测试环境下面也可以通过某种方式(比如delete)来禁用不支持小程序的API,从而达到测试环境尽可能的贴近小程序的正式环境。当然更希望的是小程序官方能给出相应的单元测试方案吧。

原创声明,本文系作者授权云+社区-专栏发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

编辑于

我来说两句

2 条评论
登录 后参与评论

相关文章

来自专栏Java技术分享

基于Metronic的Bootstrap开发框架经验总结(5)--Bootstrap文件上传插件File Input的使用

Bootstrap文件上传插件File Input是一个不错的文件上传控件,但是搜索使用到的案例不多,使用的时候,也是一步一个脚印一样摸着石头过河,这个控件在界...

2239
来自专栏Android机动车

使用Fiddler抓取bilibili安卓客户端口数据并分析http、https

经过了一个多星期的时间(自2017/10/16开始),到目前(2017/10/24)为止,项目框架的搭建已基本完成、还完成了首页中「直播」与「推荐」Fragme...

681
来自专栏张善友的专栏

JSON 和 JSONP

浏览器安全模型规定,XMLHttpRequest、框架(frame)等只能在一个域中通信。从安全角度考虑,这个规定很合理;但是,也确实给分布式(面向服务、混搭等...

1697
来自专栏企鹅号快讯

Python3爬取1024图片

分析 列表页面 首先进入1024的导航网站,随便点击一个地址进入选择图片区或者在网站地址后面添加,这就是1024网站的图片区,这个爬虫就是主要抓取这个区域的所有...

3179
来自专栏Coding01

推荐一款 phpcs 插件规范 Laravel 代码 (规范从本地写代码到版本控制)

我相信每个公司都有一套完备的代码规范标准,但标准是标准,如何能有效的让所有人遵守,那就要工具的辅助和实时提醒了。

654
来自专栏Android研究院

Android组件化专题 - 组件化配置

(摘自百度百科)模块化是指解决一个复杂的问题时自顶向下逐层把系统划分为若干个模块的过程,各个模块可独立工作。

813
来自专栏前端架构

基于requireJS和angularJS的前端技术架构

   1、初步加载初始页面如index.html,首先加载样式文件,再加载requireJS配置文件和源文件。

721
来自专栏Coco的专栏

【前端工具】Chrome 扩展程序的开发与发布 -- 手把手教你开发扩展程序

1753
来自专栏Coco的专栏

【前端工具】Chrome 扩展程序的开发与发布 -- 手把手教你开发扩展程序

1303
来自专栏用户2442861的专栏

Chrome开发者工具不完全指南(二、进阶篇)

上篇向大家介绍完了基础功能篇,这次分享的是Chrome开发工具中最有用的面板Sources。  Sources面板几乎是我最常用到的Chrome功能面板,也是...

471

扫码关注云+社区