psybizz/http-endpoint-tester

Test application for http(s) endpoints written in node.js

http-endpoint-tester

A HTTP endpoint tester using node.js, inspired by the node-test-tutorial of David Beath and the talk of Danny Dinneen at the 2014 edition of the Endpoint conference., _(*1)

The tool is written to be used in a CI pipeline with jenkins, to test endpoints of rest(ful) API's. That's why it depends on environment variables, this makes it easy to use the tool in a CI pipeline., _(*2)

Usage

initialise environment

npm install, _(*3)

This will install/update all the required modules for running the tests, _(*4)

Also a composer wrapper is provided, implemented to keep our own jenkins as stupid as possible ;), _(*5)

Run tests

ENDPOINT_PATHS=<path/to/paths/file.json> ENDPOINT_HOST=<host>:<port> SITE_URI=<FQDN> ./node_modules/.bin/mocha --ui tdd, _(*6)

Adding paths to test

Select the project in resources Open paths.json and add the following stanza:, _(*7)

json [ { "path": "/api/info", "method": "GET", "headers": { "header1": "value1", "header2": "value2" }, "statusCode": [200, 302], "public": 1, "secure": 0, "requireFQDN": 0, "timeout": 500 }, { // another stanza } ], _(*8)

path: path to test
method: GET,POST, PUT or PATCH
statuscode: [statuscode(s)]
public: should endpoint be available in production
secure: use http or https (needs to be implemented) timeout: timeout in milliseconds
requireFQDN: mark a test as optional or required when an site uri has been specified. ( optional parameter ), _(*9)

public and secure are not implemented yet., _(*10)

NOTE on site_uri: this will be set as host header in the request object as demanded by the HTTP1.1 standard, but the request/request implementation will use this value as proxy. So when the tested host is not identical to the site_uri, you are strongly advised to specify followRedirects to false., _(*11)

Resources

• Request class for node.js
• Mocha test framework
• Chai assertion library

Todo

• implement https support