https://github.com/csabapalfi/node-testing-tips
đŸ”¬Testing Node.js apps like you mean it, Aug 2014
https://github.com/csabapalfi/node-testing-tips
blogpost
Last synced: 2 months ago
JSON representation
đŸ”¬Testing Node.js apps like you mean it, Aug 2014
- Host: GitHub
- URL: https://github.com/csabapalfi/node-testing-tips
- Owner: csabapalfi
- Created: 2016-10-08T07:06:10.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-19T19:48:25.000Z (about 8 years ago)
- Last Synced: 2025-01-25T14:21:30.083Z (4 months ago)
- Topics: blogpost
- Homepage: https://csabapalfi.github.io/node-testing-tips
- Size: 1.95 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Testing Node.js apps like you mean it
[Csaba Palfi](https://csabapalfi.github.io), Aug 2014
I'm now working mostly with Node.js and really happy with the development setup we have. In this post I tried to collect how we do some of our testing.
## instant test feedback
... with `nodemon` and `growl`
You surely came across [nodemon](http://nodemon.io/). It watches your project files and restarts your server. We also use it to watch and continuously run our tests during development (as a replacement to the not so reliable `mocha --watch` - **update**: mocha watch is cool these days). You can override the nodemon defaults so that it watches more filetypes. (`-e js,json,handlebars`)
Now you have your test running but you have to keep switching to your terminal to see if they pass. Mocha has [Growl integration](https://github.com/visionmedia/node-growl#installation) to help with that. (`--growl`)
Assuming you have nodemon and mocha+Growl setup and your tests are in the ```test``` directory this command keeps running your tests and notifies you if they pass or fail:
```sh
nodemon -e js,json,handlebars node_modules/mocha/bin/mocha test/ --recursive --growl --reporter spec
```
You can press save in your editor and expect a Growl notification to tell you the results.
## keeping your tests clean
... with `unroll`
It's fairly common to run the same tests with different parameters (e.g. you have Scenario Outlines for Cucumber). You can use the brilliant [unroll](https://github.com/lawrencec/Unroll) module to achieve similar things with Node test frameworks. Just replace a mocha `it()` with unroll like below. It'll produce nicely formatted test description, too.
```js
unroll('#a plus #b is #c',
function(done, testArgs) {
expect(
testArgs.a + testArgs.b
).to.be.equal(testArgs.c);
done();
},
[
['a', 'b', 'c'],
[ 3, 5, 8 ],
[ 7, 0, 7 ]
]
);
```
## easy acceptance testing
... with `nock` and `cheerio`
Our current stack consists of small Node.js microservices. Most of them just talk to other services via HTTP and either return JSON or render HTML. In our acceptance tests we want to test an entire microservice but mocking their dependencies and asserting on the response they produce.
[Nock](https://github.com/pgte/nock) overrides Node's `http.request` function and allows you to control what's going to be the reply to HTTP requests made by your app.
Let's see a simple example:
```js
// From now on all requests to example.com/test are mocked
nock('http://www.example.com')
.get('/test')
.reply(200);
```
It also allows you to control the response body and has a brilliant [recording](https://github.com/pgte/nock#recording) feature as well.
Now that we're in control of our dependencies we can just run and hit our app with [supertest](https://github.com/visionmedia/supertest) and assert on it's response which is really easy if that's JSON.
[Cheerio](https://github.com/cheeriojs/cheerio) comes handy when we have to assert on an HTML response. Cheerio is a fast implementation of JQuery core for the server.
```js
$ = cheerio.load(htmlResponse);
expect(
$('h2.title').text()
).to.be('Hi there!');
```
And we're now testing a complete service in isolation from interaction with dependencies to template rendering. Of course this doesn't replace functional testing with WebDriver but certainly can make functional tests simpler and let them focus on the right things.
