Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gobum/ihope
The most simplest test library in the world for JavaScript.
https://github.com/gobum/ihope
Last synced: about 2 months ago
JSON representation
The most simplest test library in the world for JavaScript.
- Host: GitHub
- URL: https://github.com/gobum/ihope
- Owner: h6js
- Created: 2017-09-02T01:19:02.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-01-15T01:11:51.000Z (over 6 years ago)
- Last Synced: 2024-05-23T05:29:10.443Z (4 months ago)
- Language: JavaScript
- Size: 180 KB
- Stars: 40
- Watchers: 5
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ihope
__世界上最简单的 JavaScript 测试库。__
https://github.com/gobum/ihope
不到 1100 行源码，丑化后 11kb，拉链后 5kb，零依赖，太小，太简单，慎用！
ihope 由丐帮（gobum.org）开发并维护。莫读源码，太烂 ...
## 用法
### Node 环境：
安装：
```bash
npm install ihope
```
使用：
```js
var I = require('ihope');
I.do('My First Test', function(I){
// 测试代码：
var text = 'hello' + ' ' + 'world';
// 测试断言：
I.hope(text).is.string;
I.hope(text).is.equal('hello world');
// 测试统计：
I.sum();
});
```
终端输出：
### 浏览器环境
用法：
```html
ihope in browser
</head>
<body>
<script>
I.do('My First Test', function(I){
// 测试代码：
var text = 'hello' + ' ' + 'world';
// 测试断言：
I.hope(text).is.string;
I.hope(text).is.equal('hello world');
// 测试统计：
I.sum();
});
```
控制台输出：
## 特点
### 测试框架与断言库一体化
之前的大多数测试需要一个测试框架库和一个断言库，例如。而 ihope 将测试框架和断言库集成为一个整体，因此只要引入 ihope 就够了。
### 断言自描述
ihope 的断言用法本身（例如，`I.hope(text).is.string;` ）已经足够描述测试断言的本意，根本无须额外的断言描述信息，这可极大方便了测试用例的编写。
### 支持同步和异步测试用例的书写
若测试用例的执行函数是 `function (I){ ... }` 这种普通函数写法，则是编写同步测试用例；若测试用例的执行函数是 `function* (I){ ... }` 这种 GeneratorFunction 或 `async function (I){ ... }` 这种 AsyncFunction 写法，则可在其中编写异步测试用例。
## 主要功能
### 一般测试用例写法：
```js
I.do('Test Hello World', function (I) {
I.do('Test Hello', function (I) {
var hello = 'hello';
I.hope(hello).equal('hello');
});
I.do('Test World', function (I) {
var world = 'world';
I.hope(world).is.string;
});
I.sum();
});
```
输出：
用 I.do() 开始一个测试用例，给用例指定一个描述，并给出一个测试函数。其中，测试函数的参数是下一层的 I 对象，可使用其方法进行各种断言测试，或开始一个子测试用例。
一般，在测试用例函数的末尾，可以调用 I.sum() 对测试点进行汇总报告。
那些 `I.hope(hello).equal('hello');` 等测试点本身是自描述的，测试成功或失败都会以这段代码作为测试点的描述信息。
### 也可用文字描述测试点
ihope 建议尽量使用自描述的测试断言，但你一定要用文字描述也是可以的：
```js
describe('My Test', function(I){
var args = {0:'a', 1:'b', 2: 'c', length: 3};
I.say('args is an array like object').as(args).has.property('length');
I.say('args is not empty').if(args.length>0);
I.say('Every element in args is ok').on(function(){
for(var i=0; i 1000).is.ok;
});
```
输出：
`function* (I) {...}` 启动异步测试，其中可以自然地配合 `yield` 关键字处理任何异步等待操作。ihope 内置对 Generator 代码的运行调度机制，您可以在其中嵌套任何同步或异步的子测试，这些测试都会依据层次逻辑依次运行。
### async 测试函数
上面的用例简单改为 `async function(I){...}` 并配合 `await` 关键字，就是 async 的测试代码：
```js
I.do('This is async function test case:', async function (I) {
var zero = Date.now();
var delta = Date.now() - zero;
I.hope(delta).is.equal(0);
await I.delay(1000);
delta = Date.now() - zero;
I.hope(delta > 1000).is.ok;
});
```
输出：
## 文档
没时间写 ...
-- 李战(leadzen) 2017.09.19 杭州