FAQ

常见问题

如何安装 KAB？

KAB 运行于 Node.js 环境，因此需要保证已经安装 Node.js 之后再执行以下命令：

$ [sudo] npm install fecs -g

如果安装失败报权限相关的问题，请使用 sudo。

如何编写性能测试代码？

kab 的性能对比测试基于 Benchmark.js，通常一个完整的测试代码如下：

var suite = new Benchmark.Suite('Contains');

// add tests
suite.add('RegExp#test', function() {
  /o/.test('Hello World!');
})
.add('String#indexOf', function() {
  'Hello World!'.indexOf('o') > -1;
})
.add('String#match', function() {
  !!'Hello World!'.match(/o/);
})
// add listeners
.on('cycle', function(event) {
  console.log(String(event.target));
})
.on('complete', function() {
  console.log('Fastest is ' + this.filter('fastest').map('name'));
})
// run async
.run({ 'async': true });

如果在浏览器端，还需要准备好引入相关的依赖：

<script src="lodash.js"></script>
<script src="platform.js"></script>
<script src="benchmark.js"></script>

然后在目标浏览器中运行测试，每个浏览器重复一次。

使用 kab，只需要编写一个 Markdown：

## Contains

### String#indexOf

​```javascript
'Hello World!'.indexOf('o') > -1;
​```

### RegExp#test

​```javascript
/o/.test('Hello World!');
​```

注意标题的层级关系，各个标题下的 HTML 或 CSS 代码块也将自动嵌入页面。

假设文件名为 perf.md，在 Node.js 下运行：

$ kab perf.md --node

多个测试文件：

$ kab perf.md perf1.md --node

或者：

$ kab *.md --node

同样的文件在浏览器端测试：

$ kab *.md --browsers=Chrome,Firefox

一切如此简单，世界如此美好。