3.4 KiB
Statuses
HTTP status utility for node.
This module provides a list of status codes and messages sourced from a few different projects:
Installation
This is a Node.js module
available through the npm registry.
Installation is done using the npm install
command:
$ npm install statuses
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) // => 403
status('403') // => 403
status('forbidden') // => 403
status('Forbidden') // => 403
status(306) // throws, as it's not supported by node.js
status.STATUS_CODES
Returns an object which maps status codes to status messages, in the same format as the Node.js http module.
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.
404] // => 'Not Found' status[
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.
'not found'] // => 404
status['Not Found'] // => 404 status[
status.redirect[code]
Returns true
if a status code is a valid redirect
status.
.redirect[200] // => undefined
status.redirect[301] // => true status
status.empty[code]
Returns true
if a status code expects an empty body.
.empty[200] // => undefined
status.empty[204] // => true
status.empty[304] // => true status
status.retry[code]
Returns true
if you should retry the rest.
.retry[501] // => undefined
status.retry[503] // => true status