Download
A super-agent driven library for testing node.js HTTP servers using a fluent API. The motivation with this module is to provide a high-level abstraction for testing HTTP, while still allowing you to drop down to the lower-level API provided by superagent. Install SuperTest as an npm module and save it to your package.json file as a development dependency. You may pass an http.Server, or a Function to request(), if the server is not already listening for connections then it is bound to an ephemeral port for you so there is no need to keep track of ports. One thing to note, is that superagent now sends any HTTP error (anything other than a 2XX response code) to the callback as the first argument if you do not add a status code expect (i.e. .expect(302)). Expectations are run in the order of definition. This characteristic can be used to modify the response body or headers before executing an assertion.
Features
- SuperTest works with any test framework
- HTTP assertions made easy via superagent
- Anything you can do with superagent, you can do with supertest
- Passing the app or url each time is not necessary, if you're testing the same host you may simply re-assign the request variable with the initialization app or url
- You may use any superagent methods, including .write(), .pipe() etc and perform assertions in the .end() callback for lower-level needs
- You can test node.js HTTP servers using a fluent API
Project Samples
