Skip to content

Commit

Permalink
doc: benchmark/README.md copyedit
Browse files Browse the repository at this point in the history
  • Loading branch information
Trott committed Jun 13, 2015
1 parent 4285265 commit f2043d5
Showing 1 changed file with 11 additions and 5 deletions.
16 changes: 11 additions & 5 deletions benchmark/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,11 @@ These are most often available through your preferred package manager.

## How to run tests

There are two ways to run benchmark tests:
There are three ways to run benchmark tests:

1. Run all tests of a given type, for example, buffers
### Run all tests of a given type

For example, buffers:

```sh
iojs benchmark/common.js buffers
Expand All @@ -24,7 +26,7 @@ iojs benchmark/common.js buffers
The above command will find all scripts under `buffers` directory and require
each of them as a module. When a test script is required, it creates an instance
of `Benchmark` (a class defined in common.js). In the next tick, the `Benchmark`
constructor iterates through the configuration object property values and run
constructor iterates through the configuration object property values and runs
the test function with each of the combined arguments in spawned processes. For
example, buffers/buffer-read.js has the following configuration:

Expand Down Expand Up @@ -75,7 +77,11 @@ buffers/buffer-read.js noAssert=false buffer=fast type=UInt16BE millions=1: 244.
...
```

2. Run an individual test, for example, buffer-slice.js
The last number is the rate of operations. Higher is better.

### Run an individual test

For example, buffer-slice.js:

```sh
iojs benchmark/buffers/buffer-read.js
Expand All @@ -88,7 +94,7 @@ buffers/buffer-read.js noAssert=false buffer=fast type=UInt16BE millions=1: 245.
...
```

3. Run tests with options
### Run tests with options

This example will run only the first type of url test, with one iteration.
(Note: benchmarks require __many__ iterations to be statistically accurate.)
Expand Down

0 comments on commit f2043d5

Please sign in to comment.