@createdbyjurand/status-codes

A comprehensive HTTP status codes enum for TypeScript and JavaScript projects.

Table of contents

• Installation
• Usage
  • Status Code Enum
  • Categorized Status Codes
  • Status Code Names
  • Validation Functions
  • Specific Status Checks
  • Reverse Lookup
• Available Functions
• Available Status Codes
• Status Code Names Reference
  • Complete List of Status Code Names
• License
• Changelog
  • 5.0.0 (2025-04-18)
  • 4.0.0 (2024-03-14)
  • 3.0.0 (2023-12-15)
  • 2.0.0 (2023-06-20)
  • 1.0.0 (2023-01-10)

Installation

Back to top

npm i @createdbyjurand/status-codes

Usage

Back to top

import {
  StatusCode,
  StatusCodes,
  statusCodeNames,
  isValidStatusCode,
  isSuccess,
  isClientError,
  isServerError,
  isNotFound,
  getStatusCodeByName,
} from '@createdbyjurand/status-codes';

Status Code Enum

// Using status code enum
if (response.status === StatusCode.OK) {
  console.log('Request successful!');
}

Categorized Status Codes

// Access codes by category
console.log(StatusCodes.SUCCESS.OK); // 200
console.log(StatusCodes.CLIENT_ERROR.NOT_FOUND); // 404
console.log(StatusCodes.SERVER_ERROR.INTERNAL_SERVER_ERROR); // 500

// Iterate through all client errors
Object.entries(StatusCodes.CLIENT_ERROR).forEach(([name, code]) => {
  console.log(`${name}: ${code}`);
});

Status Code Names

// Getting status code name
const statusName = statusCodeNames[200]; // "Ok"

Validation Functions

// Validating status codes
if (isValidStatusCode(404)) {
  console.log('Valid status code');
}

// Category checking
if (isSuccess(response.status)) {
  console.log('Request was successful');
}

if (isClientError(response.status)) {
  console.log('Client made an error');
}

if (isServerError(response.status)) {
  console.log('Server encountered an error');
}

Specific Status Checks

// Check for specific conditions
if (isNotFound(response.status)) {
  console.log('Resource not found');
}

if (requiresAuthentication(response.status)) {
  console.log('Authentication required');
}

if (isRateLimited(response.status)) {
  console.log('Rate limit exceeded');
}

Reverse Lookup

// Get status code from its name
const code = getStatusCodeByName('not found'); // Returns 404
const code = getStatusCodeByName('Not Found'); // Returns 404
const code = getStatusCodeByName('Not_Found'); // Returns 404
const code = getStatusCodeByName('NOT_FOUND'); // Returns 404

Available Functions

Back to top

| Function | Description | | ------------------------------ | -------------------------------------------------------- | | isValidStatusCode(code) | Checks if a code is a valid HTTP status code | | isInformational(code) | Checks if status code is informational (100-199) | | isSuccess(code) | Checks if status code indicates success (200-299) | | isRedirect(code) | Checks if status code indicates redirection (300-399) | | isClientError(code) | Checks if status code indicates client error (400-499) | | isServerError(code) | Checks if status code indicates server error (500-599) | | requiresAuthentication(code) | Checks if status code requires authentication (401) | | isNotFound(code) | Checks if status code indicates resource not found (404) | | isRateLimited(code) | Checks if status code indicates rate limiting (429) | | getStatusCodeByName(name) | Get status code by name (case insensitive) |

Available Status Codes

Back to top

The enum provides comprehensive HTTP status codes:

export enum StatusCode {
  /* 1   ********* INFO *********/
  /* 100 */ CONTINUE = 100,
  /* 101 */ SWITCHING_PROTOCOLS = 101,
  /* 102 */ PROCESSING = 102,
  /* 103 */ EARLY_HINTS = 103, // Experimental
  /* 2   ********* SUCCESS *********/
  /* 200 */ OK = 200,
  /* 201 */ CREATED = 201,
  /* 202 */ ACCEPTED = 202,
  /* 203 */ NON_AUTHORITATIVE_INFORMATION = 203,
  /* 204 */ NO_CONTENT = 204,
  /* 205 */ RESET_CONTENT = 205,
  /* 206 */ PARTIAL_CONTENT = 206,
  /* 207 */ MULTI_STATUS = 207,
  /* 208 */ ALREADY_REPORTED = 208,
  /* 226 */ IM_USED = 226,
  /* 3   ********* REDIRECT *********/
  /* 300 */ MULTIPLE_CHOICES = 300,
  /* 301 */ MOVED_PERMANENTLY = 301,
  /* 302 */ FOUND = 302, // Previously "MOVED_TEMPORARILY"
  /* 303 */ SEE_OTHER = 303,
  /* 304 */ NOT_MODIFIED = 304,
  /* 305 */ USE_PROXY = 305,
  /* 306 */ SWITCH_PROXY = 306,
  /* 307 */ TEMPORARY_REDIRECT = 307,
  /* 308 */ PERMANENT_REDIRECT = 308,
  /* 4   ********* CLIENT_ERROR *********/
  /* 400 */ BAD_REQUEST = 400,
  /* 401 */ UNAUTHORIZED = 401,
  /* 402 */ PAYMENT_REQUIRED = 402,
  /* 403 */ FORBIDDEN = 403,
  /* 404 */ NOT_FOUND = 404,
  /* 405 */ METHOD_NOT_ALLOWED = 405,
  /* 406 */ NOT_ACCEPTABLE = 406,
  /* 407 */ PROXY_AUTHENTICATION_REQUIRED = 407,
  /* 408 */ REQUEST_TIMEOUT = 408,
  /* 409 */ CONFLICT = 409,
  /* 410 */ GONE = 410,
  /* 411 */ LENGTH_REQUIRED = 411,
  /* 412 */ PRECONDITION_FAILED = 412,
  /* 413 */ PAYLOAD_TOO_LARGE = 413,
  /* 414 */ URI_TOO_LONG = 414,
  /* 415 */ UNSUPPORTED_MEDIA_TYPE = 415,
  /* 416 */ RANGE_NOT_SATISFIABLE = 416,
  /* 417 */ EXPECTATION_FAILED = 417,
  /* 418 */ IM_A_TEAPOT = 418,
  /* 420 */ ENHANCE_YOUR_CALM = 420, // Non-standard, specific to Twitter
  /* 421 */ MISDIRECTED_REQUEST = 421,
  /* 422 */ UNPROCESSABLE_ENTITY = 422,
  /* 423 */ LOCKED = 423,
  /* 424 */ FAILED_DEPENDENCY = 424,
  /* 425 */ TOO_EARLY = 425,
  /* 426 */ UPGRADE_REQUIRED = 426,
  /* 428 */ PRECONDITION_REQUIRED = 428,
  /* 429 */ TOO_MANY_REQUESTS = 429,
  /* 431 */ REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
  /* 440 */ LOGIN_TIME_OUT = 440, // Non-standard, specific to Microsoft IIS
  /* 444 */ NO_RESPONSE = 444, // Non-standard, specific to Nginx
  /* 449 */ RETRY_WITH = 449, // Non-standard, specific to Microsoft IIS
  /* 450 */ BLOCKED_BY_WINDOWS_PARENTAL_CONTROLS = 450, // Non-standard, specific to Microsoft IIS
  /* 451 */ UNAVAILABLE_FOR_LEGAL_REASONS = 451,
  /* 499 */ CLIENT_CLOSED_REQUEST = 499,
  /* 5   ********* SERVER_ERROR *********/
  /* 500 */ INTERNAL_SERVER_ERROR = 500,
  /* 501 */ NOT_IMPLEMENTED = 501,
  /* 502 */ BAD_GATEWAY = 502,
  /* 503 */ SERVICE_UNAVAILABLE = 503,
  /* 504 */ GATEWAY_TIMEOUT = 504,
  /* 505 */ HTTP_VERSION_NOT_SUPPORTED = 505,
  /* 506 */ VARIANT_ALSO_NEGOTIATES = 506,
  /* 507 */ INSUFFICIENT_STORAGE = 507,
  /* 508 */ LOOP_DETECTED = 508,
  /* 509 */ BANDWIDTH_LIMIT_EXCEEDED = 509, // Non-standard, hosting-specific
  /* 510 */ NOT_EXTENDED = 510,
  /* 511 */ NETWORK_AUTHENTICATION_REQUIRED = 511,
  /* 598 */ NETWORK_READ_TIMEOUT = 598, // Non-standard, proxy-specific
  /* 599 */ NETWORK_CONNECT_TIMEOUT = 599, // Non-standard, proxy-specific
}

Status Code Names Reference

Back to top

statusCodeNames is an object that holds mirrored enum data where key is a status code number and value is human readable status name.

export const statusCodeNames: Record<number, string> = Object.fromEntries(
  Object.entries(StatusCode).map(([key, value]) => [
    value,
    key
      .replace(/_/g, ' ') // Replace underscores with spaces
      .toLowerCase() // Convert to lowercase
      .replace(/\b\w/g, char => char.toUpperCase()), // Capitalize each word
  ]),
);

Complete List of Status Code Names

Here's a complete example showing all status code names from the statusCodeNames object:

import {statusCodeNames} from '@createdbyjurand/status-codes';

// Information responses (100-199)
console.log(statusCodeNames[100]); // "Continue"
console.log(statusCodeNames[101]); // "Switching Protocols"
console.log(statusCodeNames[102]); // "Processing"
console.log(statusCodeNames[103]); // "Early Hints"

// Success responses (200-299)
console.log(statusCodeNames[200]); // "Ok"
console.log(statusCodeNames[201]); // "Created"
console.log(statusCodeNames[202]); // "Accepted"
console.log(statusCodeNames[203]); // "Non Authoritative Information"
console.log(statusCodeNames[204]); // "No Content"
console.log(statusCodeNames[205]); // "Reset Content"
console.log(statusCodeNames[206]); // "Partial Content"
console.log(statusCodeNames[207]); // "Multi Status"
console.log(statusCodeNames[208]); // "Already Reported"
console.log(statusCodeNames[226]); // "Im Used"

// Redirection responses (300-399)
console.log(statusCodeNames[300]); // "Multiple Choices"
console.log(statusCodeNames[301]); // "Moved Permanently"
console.log(statusCodeNames[302]); // "Found"
console.log(statusCodeNames[303]); // "See Other"
console.log(statusCodeNames[304]); // "Not Modified"
console.log(statusCodeNames[305]); // "Use Proxy"
console.log(statusCodeNames[306]); // "Switch Proxy"
console.log(statusCodeNames[307]); // "Temporary Redirect"
console.log(statusCodeNames[308]); // "Permanent Redirect"

// Client error responses (400-499)
console.log(statusCodeNames[400]); // "Bad Request"
console.log(statusCodeNames[401]); // "Unauthorized"
console.log(statusCodeNames[402]); // "Payment Required"
console.log(statusCodeNames[403]); // "Forbidden"
console.log(statusCodeNames[404]); // "Not Found"
console.log(statusCodeNames[405]); // "Method Not Allowed"
console.log(statusCodeNames[406]); // "Not Acceptable"
console.log(statusCodeNames[407]); // "Proxy Authentication Required"
console.log(statusCodeNames[408]); // "Request Timeout"
console.log(statusCodeNames[409]); // "Conflict"
console.log(statusCodeNames[410]); // "Gone"
console.log(statusCodeNames[411]); // "Length Required"
console.log(statusCodeNames[412]); // "Precondition Failed"
console.log(statusCodeNames[413]); // "Payload Too Large"
console.log(statusCodeNames[414]); // "Uri Too Long"
console.log(statusCodeNames[415]); // "Unsupported Media Type"
console.log(statusCodeNames[416]); // "Range Not Satisfiable"
console.log(statusCodeNames[417]); // "Expectation Failed"
console.log(statusCodeNames[418]); // "Im A Teapot"
console.log(statusCodeNames[420]); // "Enhance Your Calm"
console.log(statusCodeNames[421]); // "Misdirected Request"
console.log(statusCodeNames[422]); // "Unprocessable Entity"
console.log(statusCodeNames[423]); // "Locked"
console.log(statusCodeNames[424]); // "Failed Dependency"
console.log(statusCodeNames[425]); // "Too Early"
console.log(statusCodeNames[426]); // "Upgrade Required"
console.log(statusCodeNames[428]); // "Precondition Required"
console.log(statusCodeNames[429]); // "Too Many Requests"
console.log(statusCodeNames[431]); // "Request Header Fields Too Large"
console.log(statusCodeNames[440]); // "Login Time Out"
console.log(statusCodeNames[444]); // "No Response"
console.log(statusCodeNames[449]); // "Retry With"
console.log(statusCodeNames[450]); // "Blocked By Windows Parental Controls"
console.log(statusCodeNames[451]); // "Unavailable For Legal Reasons"
console.log(statusCodeNames[499]); // "Client Closed Request"

// Server error responses (500-599)
console.log(statusCodeNames[500]); // "Internal Server Error"
console.log(statusCodeNames[501]); // "Not Implemented"
console.log(statusCodeNames[502]); // "Bad Gateway"
console.log(statusCodeNames[503]); // "Service Unavailable"
console.log(statusCodeNames[504]); // "Gateway Timeout"
console.log(statusCodeNames[505]); // "Http Version Not Supported"
console.log(statusCodeNames[506]); // "Variant Also Negotiates"
console.log(statusCodeNames[507]); // "Insufficient Storage"
console.log(statusCodeNames[508]); // "Loop Detected"
console.log(statusCodeNames[509]); // "Bandwidth Limit Exceeded"
console.log(statusCodeNames[510]); // "Not Extended"
console.log(statusCodeNames[511]); // "Network Authentication Required"
console.log(statusCodeNames[598]); // "Network Read Timeout"
console.log(statusCodeNames[599]); // "Network Connect Timeout"

License

Back to top

ISC

Changelog

Back to top

5.0.0 (2025-04-18)

Breaking Changes

• Renamed enum members by removing category prefixes
  • INFO_CONTINUE → CONTINUE
  • SUCCESS_OK → OK
  • CLIENT_ERROR_NOT_FOUND → NOT_FOUND
  • And so on for all status codes

New Features

• Added StatusCodes object to access status codes by category:
  • StatusCodes.INFO - Information responses (100-199)
  • StatusCodes.SUCCESS - Success responses (200-299)
  • StatusCodes.REDIRECT - Redirection responses (300-399)
  • StatusCodes.CLIENT_ERROR - Client error responses (400-499)
  • StatusCodes.SERVER_ERROR - Server error responses (500-599)

Improvements

• Simplified access to status codes with cleaner naming
• Enhanced status code organization by category
• Updated documentation with new usage patterns

4.0.0 (2024-03-14)

Breaking Changes

• Renamed main enum from EStatusCode to StatusCode for better naming conventions
• Changed minimum supported TypeScript version to 4.7.0

New Features

• Added category checking functions:
  • isInformational(code) - Check if code is 100-199
  • isSuccess(code) - Check if code is 200-299
  • isRedirect(code) - Check if code is 300-399
  • isClientError(code) - Check if code is 400-499
  • isServerError(code) - Check if code is 500-599
• Added specific status helper functions:
  • requiresAuthentication(code) - Check if status code is 401
  • isNotFound(code) - Check if status code is 404
  • isRateLimited(code) - Check if status code is 429
• Added reverse lookup function:
  • getStatusCodeByName(name) - Get status code by its name

Improvements

• Improved TypeScript type safety
• Enhanced documentation with more examples
• Added complete status code name listing in README

3.0.0 (2023-12-15)

Breaking Changes

• Made package compatible with both ESM and CommonJS projects
• Updated directory structure to support dual module format
• Changed build output to include separate ESM, CommonJS and types directories

New Features

• Added isValidStatusCode() function

2.0.0 (2023-06-20)

Breaking Changes

• Complete rewrite in TypeScript
• Enhanced enum naming with category prefixes

New Features

• Added statusCodeNames object for name lookups

1.0.0 (2023-01-10)

• Initial release with basic HTTP status code enum