statuses
Advanced tools
Package description
The 'statuses' npm package provides an easy way to handle HTTP status codes. It allows you to look up status codes by the code number or by the status message. It also provides a way to retrieve the message associated with a particular status code or vice versa.
Get HTTP status code message
Retrieve the message associated with a specific HTTP status code.
"use strict";
const statuses = require('statuses');
const message = statuses[404]; // 'Not Found'Get HTTP status code by message
Retrieve the status code by specifying the message.
"use strict";
const statuses = require('statuses');
const code = statuses('Not Found'); // 404Check if status code is a redirect
Check if a given status code is classified as a redirect (3xx).
"use strict";
const statuses = require('statuses');
const isRedirect = statuses.redirect[301]; // trueGet the status code range
Determine if a status code falls within a specific range, such as informational (1xx), success (2xx), etc.
"use strict";
const statuses = require('statuses');
const isInformational = statuses.empty[204]; // true
const isSuccess = statuses.success[200]; // trueThis package provides named exports for HTTP status codes and messages, similar to 'statuses'. It allows you to use constants instead of numbers for better readability in your code.
Similar to 'statuses', 'http-status' provides an easy way to reference HTTP status codes and their messages. It also includes utility functions to check the type of status code (e.g., isSuccess, isClientError).
Readme
HTTP status utility for node.
var status = require('statuses')
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
Returns an array of all the status codes as Integers.
Map of code to status message. undefined for invalid codes.
status[404] // => 'Not Found'
Map of status message to code. msg can either be title-cased or lower-cased. undefined for invalid status messages.
status['not found'] // => 404
status['Not Found'] // => 404
Returns true if a status code is a valid redirect status.
status.redirect[200] // => undefined
status.redirect[301] // => true
Returns true if a status code expects an empty body.
status.empty[200] // => undefined
status.empty[204] // => true
status.empty[304] // => true
Returns true if you should retry the rest.
status.retry[501] // => undefined
status.retry[503] // => true
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.
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:
# update src/iana.json
npm run fetch
# build codes.json
npm run build
FAQs
HTTP status utility
The npm package statuses receives a total of 38,065,611 weekly downloads. As such, statuses popularity was classified as popular.
We found that statuses demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.
Security News
This episode of the Risky Biz podcast discusses how the rise of small open source packages and the shift towards individual maintainers makes the ecosystem more vulnerable to supply chain attacks.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.