summaryrefslogtreecommitdiff
path: root/benchmark/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'benchmark/README.md')
-rw-r--r--benchmark/README.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/benchmark/README.md b/benchmark/README.md
index 95ade9840d..ab168911af 100644
--- a/benchmark/README.md
+++ b/benchmark/README.md
@@ -3,6 +3,14 @@
This folder contains benchmark tests to measure the performance for certain
io.js APIs.
+## prerequisites
+
+Most of the http benchmarks require `wrk` to be compiled beforehand.
+
+```sh
+make wrk
+```
+
## How to run tests
There are two ways to run benchmark tests:
@@ -80,6 +88,20 @@ buffers/buffer-read.js noAssert=false buffer=fast type=UInt16BE millions=1: 245.
...
```
+3. 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.)
+
+
+```sh
+iojs benchmark/url/url-parse.js type=one n=1
+```
+Output:
+```
+url/url-parse.js type=one n=1: 1663.74402
+```
+
## How to write a benchmark test
The benchmark tests are grouped by types. Each type corresponds to a subdirectory,