Statuses
HTTP status utility for node.
API
var status = require('statuses');
var code = status(Integer || String)
If Integer
or String
is a valid HTTP code or status message, then the appropriate code
will be returned. Otherwise, an error will be thrown.
status(403)
status('403')
status('forbidden')
status('Forbidden')
status(306)
status.codes
Returns an array of all the status codes as Integer
s.
var msg = status[code]
Map of code
to status message
. undefined
for invalid code
s.
status[404]
var code = status[msg]
Map of status message
to code
. msg
can either be title-cased or lower-cased. undefined
for invalid status message
s.
status['not found']
status['Not Found']
status.redirect[code]
Returns true
if a status code is a valid redirect status.
status.redirect[200]
status.redirect[301]
status.empty[code]
Returns true
if a status code expects an empty body.
status.empty[200]
status.empty[204]
status.empty[304]
status.retry[code]
Returns true
if you should retry the rest.
status.retry[501]
status.retry[503]
statuses/codes.json
var codes = require('statuses/codes.json');
This is a JSON file of the status codes
taken from require('http').STATUS_CODES
.
This is saved so that codes are consistent even in older node.js versions.
For example, 308
will be added in v0.12.
Adding Status Codes
The status codes are primarily sourced from http://www.iana.org/assignments/http-status-codes/http-status-codes-1.csv.
Additionally, custom codes are added from http://en.wikipedia.org/wiki/List_of_HTTP_status_codes.
These are added manually in the lib/*.json
files.
If you would like to add a status code, add it to the appropriate JSON file.
To rebuild codes.json
, run the following:
npm run update
npm run build