Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); miniprogram-simulate/docs/tutorial.md at master · wechat-miniprogram/miniprogram-simulate · GitHub
Skip to content

Latest commit

History

History
202 lines (151 loc) · 5.85 KB

File metadata and controls

202 lines (151 loc) · 5.85 KB

框架选择

可搭配大部分流行框架使用,只要其满足 js 运行环境和 dom 环境即可。以下简单介绍下 jest 和 karma:

jest

  1. 安装 jest 和配置参考 jest 官网
  2. 配置 jest
    {// jest 是直接在 nodejs 环境进行测试,使用 jsdom 进行 dom 环境的模拟。在使用时需要将 jest 的 `testEnvironment` 配置为 `jsdom`。// jest 内置 jsdom,所以不需要额外引入。"testEnvironment": "jsdom",// 配置 jest-snapshot-plugin 从而在使用 jest 的 snapshot 功能时获得更加适合肉眼阅读的结构"snapshotSerializers": ["miniprogram-simulate/jest-snapshot-plugin"]}

具体的 jest 配置例子可参考 weui-miniprogram 中的配置

karma

karma 可使用浏览器真实环境来运行测试用例,但是因为小程序自定义组件的文件是割裂的,而浏览器环境没有文件系统支持,因此需要做一些特殊处理。

安装 preprocessor:

npm install --save-dev karma-dirname-preprocessor karma-filemap-preprocessor karma-webpack

配置 karma.conf.js 中的 basePath、files、preprocessors、webpack 字段:

module.exports=function(config){config.set({// 其他配置 ......basePath: path.resolve(__dirname,'./test'),// 被测试组件所在根目录,因为编译器的限制,要求所有被测组件必须在此目录下files: ['node_modules/miniprogram-simulate/build.js',// 注入 miniprogram-simulate,会在 window 下挂载 simulate 对象'test/spec/*.spec.js',// 测试用例'src/component/*',// 组件文件,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了],preprocessors: {'src/component/*': ['filemap'],// 组件文件使用 filemap 将各个文件内容注入到浏览器,路径尽量不要包含 ../ 或者 ./,不然 wcc 编译器可能识别不了'test/spec/*.spec.js': ['webpack','dirname'],// 使用 webpack 进行打包,使用 dirname 处理测试用例中的 __dirname 变量},webpack: {optimization: {minimize: false,// 不做压缩,方便调试},node: {__dirname: false,// 不注入 __dirname,由 preprocessor 来处理},},// 其他配置 ......})}

然后测试用例如下方式来编写(以使用 mocha + chai 的方式为例):

constpath=require('path')constexpect=require('chai').expectdescribe('component',()=>{it('should run successfully',()=>{// 此处直接使用 simulate 或者 window.simulate 即可,不需要再做 requireconstid=simulate.load(path.resolve(__dirname,'../src/component/index'))constcomp=simulate.render(id,{prop: 'index.test.properties'})comp.attach(document.body)// 挂载在 body 下面expect(simulate.match(comp.dom,'<wx-view class="main--index">index.test.properties</wx-view>')).to.equal(true)})})

PS:在使用 karma 测试时只支持官方编译器编译 wxml 文件,不支持使用 js 模拟的编译器,因此就算在 simulate.load 方法中配置了 compiler: 'simulate' 也不会生效。

使用指南

以下均以 miniprogram-simulate + jest 的方式来介绍。

引入测试工具

constsimulate=require('miniprogram-simulate')

起步例子

test('comp',()=>{constid=simulate.load(path.join(__dirname,'./comp'))// 加载自定义组件,返回组件 idconstcomp=simulate.render(id)// 使用 id 渲染自定义组件,返回组件封装实例constparent=document.createElement('parent-wrapper')// 创建容器节点comp.attach(parent)// 将组件插入到容器节点中,会触发 attached 生命周期expect(comp.dom.innerHTML).toBe('<div>123</div>')// 判断组件渲染结果// 执行其他的一些测试逻辑comp.detach()// 将组件从容器节点中移除,会触发 detached 生命周期})

传入初始渲染 props

test('comp',()=>{// 前略constcomp=simulate.render(id,{propName: 'propValue',})})

获取数据

test('comp',()=>{// 前略// 判断组件数据expect(comp.data).toEqual({a: 111,})})

更新数据

test('comp',()=>{// 前略// 更新组件数据comp.setData({a: 123,})})

获取子组件

test('comp',()=>{// 前略constchildComp=comp.querySelector('#child-id')expect(childComp.dom.innerHTML).toBe('<div>child</div>')})

获取子组件列表

test('comp',()=>{// 前略constchildrenComp=comp.querySelectorAll('.child-item')expect(childrenComp.length).toBe(3)})

触发事件

test('comp',()=>{// 前略comp.dispatchEvent('touchstart')// 触发组件的 touchstart 事件childComp.dispatchEvent('tap')// 触发子组件的 tap 事件})

触发生命周期

test('comp',()=>{// 前略comp.triggerLifeTime('ready')// 触发组件的 ready 生命周期childComp.triggerLifeTime('moved')// 触发子组件的 moved 生命周期})

获取组件 this

test('comp',()=>{// 前略constthat=comp.instance// 注意,此处并不是返回 comp,comp 是在组件实例上再封装了一层的对象,而这里返回的是组件实例,即组件方法定义里的 thisthat.data// 获取组件的 data 对象,这里和 comp.data 拿到的对象是一样的that.xxx()// 调用组件 methods 定义段里定义的方法})