HTTP Status Codes (statushttp)

A JavaScript library for working with HTTP status codes.

All status codes are taken from the IANA Status Code Registry.

The library works both in the front-end (VanillaJS) and the back-end (NodeJS), supporting a variety of imports. It can also be used as a command-line tool to work with HTTP status codes.

Installation

Install it via NPM.

# Local
npm i statushttp

# Global
npm i -g statushttp

Quick Start

const { sc } = require('statushttp');
// Or import { sc } from 'statushttp'; for modules

// Passing case-insensitive text with spaces
console.log(sc('not found').Code); // 404
console.log(sc(201).Desc); // "Created"

// Identifier
console.log(sc(405).Text); // "METHOD_NOT_ALLOWED"

Importing

• CommonJS

  const { statusCode, statusText, ... } = require('statushttp');

• ES6

  import { statusCode, statusText, ... } from 'statushttp';

• AMD (require.js)

  require(['main.js'], () => {
    // Assuming path for 'statushttp' configured at 'node_modules/statushttp/statushttp' inside main.js
  	require(['statushttp'], ({
  		statusCode,
  		statusText,
  		...
  	}) => {
  		...
  	});
  });

• HTML + VanillaJS

  <!-- Minified -->
  <script src='node_modules/statushttp/statushttp.min.js'></script>
  
  <!-- Not minified -->
  <script src='node_modules/statushttp/statushttp.js'></script>
  
  <script>
    	// statusText, statusCode, et cetera, are accessible now.
  </script>

List of Identifiers Used

The following identifiers are used in statushttp to identify various HTTP statuses.

Identifier	Code
CONTINUE	100
SWITCHING_PROTOCOLS	101
PROCESSING	102
EARLY_HINTS	103
OK	200
CREATED	201
ACCEPTED	202
NON_AUTHORITATIVE_INFORMATION	203
NO_CONTENT	204
RESET_CONTENT	205
PARTIAL_CONTENT	206
MULTI_STATUS	207
ALREADY_REPORTED	208
IM_USED	226
MULTIPLE_CHOICES	300
MOVED_PERMANENTLY	301
FOUND	302
SEE_OTHER	303
NOT_MODIFIED	304
USE_PROXY	305
UNUSED	306
TEMPORARY_REDIRECT	307
PERMANENT_REDIRECT	308
BAD_REQUEST	400
UNAUTHORIZED	401
PAYMENT_REQUIRED	402
FORBIDDEN	403
NOT_FOUND	404
METHOD_NOT_ALLOWED	405
NOT_ACCEPTABLE	406
PROXY_AUTHENTICATION_REQUIRED	407
REQUEST_TIMEOUT	408
CONFLICT	409
GONE	410
LENGTH_REQUIRED	411
PRECONDITION_FAILED	412
PAYLOAD_TOO_LARGE	413
URI_TOO_LONG	414
UNSUPPORTED_MEDIA_TYPE	415
RANGE_NOT_SATISFIABLE	416
EXPECTATION_FAILED	417
MISDIRECTED_REQUEST	421
UNPROCESSABLE_ENTITY	422
LOCKED	423
FAILED_DEPENDENCY	424
TOO_EARLY	425
UPGRADE_REQUIRED	426
PRECONDITION_REQUIRED	428
TOO_MANY_REQUESTS	429
REQUEST_HEADER_FIELDS_TOO_LARGE	431
UNAVAILABLE_FOR_LEGAL_REASONS	451
INTERNAL_SERVER_ERROR	500
NOT_IMPLEMENTED	501
BAD_GATEWAY	502
SERVICE_UNAVAILABLE	503
GATEWAY_TIMEOUT	504
HTTP_VERSION_NOT_SUPPORTED	505
VARIANT_ALSO_NEGOTIATES	506
INSUFFICIENT_STORAGE	507
LOOP_DETECTED	508
NOT_EXTENDED	510
NETWORK_AUTHENTICATION_REQUIRED	511

Usage (JavaScript)

The following objects are accessible from statushttp:

• statusCode : Textual identifiers mapped to numeric codes.
• statusText : Numeric codes mapped to textual identifiers.
• statusDesc : User-friendly status messages/descriptions.
• statusClass : Enumerations for status classes.
• StatusCode : A class implementation for status codes to provide ease in working with status codes.
• sc : An alias for the StatusCode class constructor.

Examples:

console.log(statusCode.NOT_FOUND); // 404
console.log(statusText[502]); // BAD_GATEWAY
console.log(statusDesc[301]); // Moved Permanently
console.log(statusClass.SUCCESS); // 2

The StatusCode class

The StatusCode class provides functionality to facilitate working with HTTP status codes.

The class itself is inherited from String, and behaves as a user-friendly message string by default.

Constructor

The constructor receives one parameter, which may be a number representing the status code, or the status text (case-insensitive, with or without the hyphens and parentheses).

Examples:

let   successStatus = new StatusCode(200);
      successStatus = sc(200); // Using the alias
const createdStatus = sc('created');
const continueStatus = sc('ConTinUe');

Object Properties

• Code : The numerical code for the status.
• Text : A textual identifier for the status.
• Desc : A user-friendly status message.
• Class : The status class enumeration for the status (can be matched from statusClass properties).

Examples:

• console.log(successStatus.Text); // OK
  
  console.log(createdStatus); // Created
  console.log(createdStatus.Code); // 201
  
  console.log(continueStatus.Desc); // Continue
  console.log(continueStatus.Class); // 1

Usage (Command-Line)

statushttp can directly be used from the command-line if installed globally. Alterntively, in a project-specific installation, it may be executed using npx.

statushttp <value> [options] # Global installation
npx statushttp <value> [options] # Local installation

The value here may be a number representing the status code, or the status text (case-insensitive, with or without the hyphens and parentheses).

Even if value contains spaces, it doesn't need to be sent as one parameter enclosed in quotes.

Options:

Option	Description
-l, --list	Show all status codes.
-?, --help	Show help.
-v, --version	Displays the version.

Examples:

> statushttp ok

Status Code: 200
Textual Identifier: OK
Message: OK
Class: SUCCESS

> statushttp 304

Status Code: 304
Textual Identifier: NOT_MODIFIED
Message: Not Modified
Class: REDIRECTIONAL

> statushttp temporary redirect

Status Code: 307
Textual Identifier: TEMPORARY_REDIRECT
Message: Temporary Redirect
Class: REDIRECTIONAL

> statushttp 'not found'

Status Code: 404
Textual Identifier: NOT_FOUND
Message: Not Found
Class: CLIENT_ERROR

> statushttp --list

┌──────┬─────────────────────────────────┐
│ Code │ Message                         │
├──────┼─────────────────────────────────┤
│ 100  │ Continue                        │
├──────┼─────────────────────────────────┤
│ 101  │ Switching Protocols             │
├──────┼─────────────────────────────────┤
│ ...  │ ...                             │
├──────┼─────────────────────────────────┤
│ 510  │ Not Extended                    │
├──────┼─────────────────────────────────┤
│ 511  │ Network Authentication Required │
└──────┴─────────────────────────────────┘

Examples

• An Express server:

  const express = require('express');
  const cors = require('cors');
  const { statusCode, statusDesc } = require('statushttp');
  
  const app = express();
  
  app.use(cors());
  
  app.route('/*')
  .all((req, res) => {
  	res.status(statusCode.NOT_FOUND).end(statusDesc[statusCode.NOT_FOUND]);
  });
  
  app.listen(5000);

• A React application:

  import react, { useState } from 'react';
  import axios from 'axios';
  import { sc } from 'statushttp';
  
  const App = () => {
    const [resp, setResp] = useState(null);
  
    if (resp == null) {
      axios.get('http://localhost:5000')
        .then(r => setResp(r))
        .catch(e => setResp(e.response));
    }
  
    return <h1>{sc(resp?.status || 200)}</h1>;
  };
  
  export default App;

Development

• Clone the Git repository.

  git clone https://github.com/paramsiddharth/statushttp.git

• Install the dependencies.

  cd statushttp
  npm ci

• Install the development code as a global module.

  npm i -g .

• Build the ESM wrapper and the minified form of the development code.

  npm run build

• Test the library.

  npm test

  Test with your own values.

  cd tests
  node test 'service unavailable'

  Test the minified web version by running tests/Web.html.

Contribution

Contributions are welcome via GitHub.

• Raise issues via GitHub.
• Fork the repository.
• Clone the fork.
• Setup the development environment as described above.
• Commit and push changes to the forked repository.
• Create a pull request.

Made with ❤ by Param.