power-assert
什么是 power-assert
用官网的话答复
- 是 JavaScript 中“Power Assert”概念的实现。
- 通过规范断言接口提供描述性断言音讯。
- 没有 API 就是最好的 API。应用 power-assert，您无需学习许多断言库 API（在大多数状况下，您须要记住的只是一个assert(any_expression)函数）
- 进行记忆大量的断言 API。只需创立返回或不返回实在值的表达式， power-assert 将在屏幕上将其作为失败音讯的一部分显示给您，而您基本无需输出音讯。
power-assert 的外围价值是相对的简略和稳固。特地是， power-assert 保持最简略的测试模式
github 地址: power-assert
前言
这个库在 github 最初一次更新是在6个月前，npm上最初一次更新在3年前，所以不是很推在荐企业级我的项目中应用，倡议只在集体或小型我的项目中应用，如果您须要足够稳固，齐全可用于生产的测试库的话，无妨去看看 Jest
power-assert 相较于许多常见的断言库最大的特点是简略弱小，并未提供很多api，上手非常简单，且易于迁徙
这篇文章会波及 power-assert 根本的浏览器和 nodejs 示例，不会波及简单的示例
根本示例
调用 assert() 传入 一个表达式 和 一个错误信息（可选） ，如果表达式值为真，则没有动作，如果值为假，则显示第二个参数传入的错误信息以及一些有用的表达式的信息
咱们轻易写一个失败的测试
const assert = require("assert");const obj = { a: {c: 4} };const arr = [1,2,34,6,7, {a: [5,7]}]assert(obj.a.c === arr[5].a[1], "断言谬误");power-assert 只须要间接导入 assert 模块
在运行之前须要通过一些解决(会主动转换为power-assert)，下文会具体解说，这里咱们先看一下输入后果
/root/RemoteWorking/powerAssert_/node_modules/empower/index.js:80 throw e; ^AssertionError [ERR_ASSERTION]: 断言谬误 # ./test/index.js:7 assert(obj.a.c === arr[5].a[1], "断言谬误") | | | | | | || | | | | | | |7 | | | | | | [5,7] | | | | | Object{a:#Array#} | | | | [1,2,34,6,7,#Object#] | | 4 false | Object{c:4} Object{a:#Object#} [number] arr[5].a[1] => 7 [number] obj.a.c => 4 at Decorator._callFunc (/root/RemoteWorking/powerAssert_/node_modules/empower-core/lib/decorator.js:114:29) at Decorator.concreteAssert (/root/RemoteWorking/powerAssert_/node_modules/empower-core/lib/decorator.js:103:17) at decoratedAssert (/root/RemoteWorking/powerAssert_/node_modules/empower-core/lib/decorate.js:49:30) at powerAssert (/root/RemoteWorking/powerAssert_/node_modules/empower-core/index.js:63:32) at Object.<anonymous> (/root/RemoteWorking/powerAssert_/test/assert.js:41:1) at Module._compile (node:internal/modules/cjs/loader:1103:14) at Object.Module._extensions..js (node:internal/modules/cjs/loader:1155:10) at Module.load (node:internal/modules/cjs/loader:981:32) at Function.Module._load (node:internal/modules/cjs/loader:822:12) at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:77:12) { generatedMessage: false, code: 'ERR_ASSERTION', actual: false, expected: true, operator: '==', powerAssertContext: { source: { content: 'assert(obj.a.c === arr[5].a[1], "断言谬误")', filepath: './test/index.js', line: 7 }, args: [ { value: false, events: [ { value: [Object], espath: 'arguments/0/left/object/object' }, { value: [Object], espath: 'arguments/0/left/object' }, { value: 4, espath: 'arguments/0/left' }, { value: [Array], espath: 'arguments/0/right/object/object/object' }, { value: [Object], espath: 'arguments/0/right/object/object' }, { value: [Array], espath: 'arguments/0/right/object' }, { value: 7, espath: 'arguments/0/right' }, { value: false, espath: 'arguments/0' } ] } ] }}能够看出，power-assert 会输入表达式每个局部的值，下方还输入了该表达式更加具体的上下文信息，提供了极具参考价值的信息，在很多状况下，咱们不再须要像其它测试库一样手动打印信息
疾速上手
疾速体验
能够应用官网示例疾速体验 power-assert
nodejs 示例: power-assert-node-seed
浏览器示例：power-assert-karma-seed
举荐用法
nodejs
nodejs 如果须要测试的文件很少，能够应用 espower-cli 间接转换代码
仅需先装置 espower-cli
而后: espower 源文件 > 输入指标文件
之后运行已转换的代码即可
像上面一样
npm install espower-cliespower ./test/some_test.js > ./build/test/some_test.jsnode ./build/test/some_test.js也能够配置一些工具做简略的自动化
对于我的项目中应用，还是倡议应用 babel-preset-power-assert 转换代码，而后再运行测试，能够应用专门的测试工具，比方官网示例中的mocha，也能够自行配置测试
浏览器应用
因为 power-assert 自身是 nodejs 模块，不反对浏览器
所以官网提供了 espowerify 来反对在浏览器中应用 power-assert
浏览器中断言谬误，谬误反馈会打印在浏览器的控制台，相比 nodejs 查看与调试更加不便
举荐做法
举荐做法在后期略微繁琐，但实用于许多官网示例之外状况
因为大多数状况下咱们不会应用 browserify，所以咱们能够依据官网的示例，稍作解决，制作一个浏览器通用的 power-assert 模块，这样能够在任何中央导入应用，剩下配置 babel babel-preset-power-assert 转换代码即可应用
上面是具体的浏览器 power-assert 模块制作步骤（如果您不想本人制作，能够移至文章开端下载已制作结束的模块）
power-assert 官网文档提到了通过 espowerify 反对浏览器咱们能够将其打包为一个浏览器可间接导入的模块，以供咱们在不同的我的项目中应用对于assert办法咱们间接导入自行打包好了的反对浏览器的power-assert模块就好而咱们只须要转换对应测试代码即可应用 power-assert打包步骤 1. 通过 browserify + espowerify 将power-assert打包为浏览器可用的模块 (须要装置browserify, espowerify, power-assert) 1.模块间接这么写 // power-assert.js const assert = require("assert"); module.exports = assert; 2. 用browserify打包该模块，即打包蕴含 power-assert 的模块,browserify 会转换某些node内置模块到,应用polyfill在浏览器中(power-assert用到了 util, buffer, assert 三个node内置模块) 运行命令转换: browserify -t espowerify 下面的文件地址 > 导出地址 这一步完结之后失去了打包结束的文件，但brwoserify没有将模块导出，所以上面须要手动导出 2. 手动增加esm格局的模块导出(批改上一步打包结束的文件) 1.在顶部增加： let assert; 底部找到 require('power-assert'),这里的require并不是node的原生函数，而是一个自定义函数,能够失去可用的power-assert模块 2.将: const assert = require("assert"); module.exports = assert; 这两行替换为: assert = require("assert"); 从而将模块赋值给上方定义的 assert 变量 3. 在底部增加： export default assert; 从而导出了咱们须要的模块，至此，打包曾经实现，该模块曾经在浏览器可用（可自在导入导出应用） 3. 压缩解决 【举荐】（可选）,应用你喜爱的工具压缩代码 因为后续频繁应用该文件，故应用 rollup + terser 压缩代码使其更小 参考 rollup 配置: // 压缩代码 import { terser } from 'rollup-plugin-terser'; // rollup.config.js export default { input: '文件地址', output: { file: '导出地址', format: 'esm' }, plugins: [ terser(), ] }; 你也能够应用其余工具，这里举荐能够用esbuild疾速压缩 执行： esbuild 文件门路 --minify --outfile=导出门路 即可生成文件 亲测 rollup 压缩进去的文件 273KB,但esbuild压缩进去的是280KB，如要频繁应用，倡议rollup + terser压缩代码通过以上步骤，咱们就制作了一个浏览器通用的 power-assert 模块
前面，咱们就能够在本人的我的项目中导入应用
就像上面一样
import assert from "模块地址";assert("表达式");与下面代码的区别只是顶部的导入
而对于代码转换的局部，咱们则是配置 babel 来实现
这样，无论是在 webpack，rollup，parcel 亦或是其它工具，咱们也能够应用 power-assert 了
最初
下面的例子在浏览器中应用比拟繁琐
您能够 间接下载 已制作结束的模块用于浏览器
因为 power-assert 相干工具较少，所以应用起来可能有些麻烦，做好后期解决，在前面就能够欢快地应用了