小程序自定义组件测试工具集
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs update doc Jan 12, 2019
src support karma Jan 12, 2019
test support karma Jan 12, 2019
.eslintrc.js add wxss support and prefix Dec 6, 2018
.gitignore init Dec 3, 2018
.npmignore add doc for api Dec 5, 2018
.travis.yml update to codecov Dec 7, 2018
LICENSE Initial commit Nov 23, 2018
README.md
build.js support karma Jan 12, 2019
index.js
karma.conf.js support karma Jan 12, 2019
package.json
webpack.config.js support karma Jan 12, 2019

README.md

miniprogram-simulate

介绍

小程序自定义组件测试工具集。

目前因为小程序独特的运行环境,所以对于小程序自定义组件的单元测试一直没有比较优雅的解决方案,此工具集就是为了解决此痛点而诞生的。将原本小程序自定义组件双线程分离运行的机制调整成单线程模拟运行,利用 dom 环境进行渲染,借此来完成整个自定义组件树的搭建。

运行此工具集需要依赖 js 运行环境和 dom 环境,因此可以采用 jsdom + nodejs(如 jest),也可以采用真实浏览器环境(如 karma)。文档使用简介中会提供简单的使用方式介绍。

安装

npm install --save-dev miniprogram-simulate

使用

const simulate = require('miniprogram-simulate')

test('test sth', () => {
    const id = simulate.load('/components/comp/index') // 加载自定义组件
    const comp = simulate.render(id) // 渲染自定义组件
    
    // 使用自定义组件封装实例 comp 对象来进行各种单元测试
})

以上只是一个简单的例子,实际上这个工具集必须搭配 jest 或 jsdom/mocha 等测试框架来使用,更为详细的使用细节请参阅下述文档:

协议

MIT