npmpackage.info

Gathering detailed insights and metrics for http-status-codes

Other packages similar to http-status-codes

builtin-status-codes

3.0.0

The map of HTTP status codes from the builtin http module

http-assert

1.5.0

assert with status codes

@readme/http-status-codes

9.0.2

Utility to lookup HTTP status codes

is-redirect

2.0.0

Check if a number is a redirect HTTP status code

Gathering detailed insights and metrics for http-status-codes

http-status-codes - 2.3.0 | npmpackage.info

http-status-codes

Constants enumerating the HTTP status codes. All status codes defined in RFC1945 (HTTP/1.0, RFC2616 (HTTP/1.1), and RFC2518 (WebDAV) are supported.

2.3.0

1,072

MIT

TypeScript

3.60 kB

371,947,947 2.7

Installations

npm install http-status-codes

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

14.17.0

NPM Version

6.14.13 Score

99.7

Supply Chain

99.6

Quality

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

23

Total

67

Closed

20

Merged

24

Issues

Open

9

Total

41

Closed

32

Releases

http-status-codes 2.3.0

v2.3.0

Updated on Sep 20, 2023

http-status-codes 2.2.0

v2.2.0

Updated on Jan 04, 2022

http-status-codes 2.1.4

v2.1.4

Updated on Sep 19, 2020

http-status-codes 2.1.3

v2.1.3

Updated on Sep 12, 2020

http-status-codes 2.1.2

2.1.2

Updated on Aug 24, 2020

http-status-codes 2.1.1

2.1.1

Updated on Aug 23, 2020

View All 9 releases

Languages

TypeScript

JavaScript

Shell

TypeScript (92.65%)

JavaScript (7.2%)

Shell (0.14%)

Developer

prettymuchbryce

Download Statistics

Total Downloads

371,947,947

Last Day

509,650

Last Week

2,597,511

Last Month

10,697,406

Last Year

110,741,377

GitHub Statistics

MIT License

1,072 Stars

81 Commits

105 Forks

7 Watchers

16 Branches

16 Contributors

Updated on May 10, 2025

Bundle Size

12.17 kB

Minified

3.60 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 16 Contributors

Package Meta Information

Latest Version

2.3.0

Package Id

http-status-codes@2.3.0

Unpacked Size

217.82 kB

Size

22.88 kB

File Count

NPM Version

6.14.13

Node Version

14.17.0

Published on

Sep 20, 2023

Total Downloads

Cumulative downloads

Total Downloads

371,947,947

Last Day

3.6%

509,650

Compared to previous day

Last Week

12.8%

2,597,511

Compared to previous week

Last Month

1.6%

10,697,406

Compared to previous month

Last Year

35.9%

110,741,377

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@types/fs-extra @types/jest @types/markdown-table @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint eslint-config-airbnb-typescript eslint-plugin-import fs-extra jest markdown-table ts-jest ts-morph ts-node typescript

http-status-codes

Constants enumerating the HTTP status codes. Based on the Java Apache HttpStatus API.

All status codes defined in RFC1945 (HTTP/1.0), RFC2616 (HTTP/1.1), RFC2518 (WebDAV), RFC6585 (Additional HTTP Status Codes), and RFC7538 (Permanent Redirect) are supported.

TypeScript or JavaScript. Completely library agnostic. No dependencies.

Installation

1npm install http-status-codes --save

Usage (express 4.x)

1import {
2	ReasonPhrases,
3	StatusCodes,
4	getReasonPhrase,
5	getStatusCode,
6} from 'http-status-codes';
7
8response
9	.status(StatusCodes.OK)
10	.send(ReasonPhrases.OK);
11
12response
13	.status(StatusCodes.INTERNAL_SERVER_ERROR)
14	.send({
15		error: getReasonPhrase(StatusCodes.INTERNAL_SERVER_ERROR)
16	});
17
18response
19	.status(getStatusCode('Internal Server Error'))
20	.send({
21		error: 'Internal Server Error'
22	});

Codes

Code	Constant	Reason Phrase
100	CONTINUE	Continue
101	SWITCHING_PROTOCOLS	Switching Protocols
102	PROCESSING	Processing
103	EARLY_HINTS	Early Hints
200	OK	OK
201	CREATED	Created
202	ACCEPTED	Accepted
203	NON_AUTHORITATIVE_INFORMATION	Non Authoritative Information
204	NO_CONTENT	No Content
205	RESET_CONTENT	Reset Content
206	PARTIAL_CONTENT	Partial Content
207	MULTI_STATUS	Multi-Status
300	MULTIPLE_CHOICES	Multiple Choices
301	MOVED_PERMANENTLY	Moved Permanently
302	MOVED_TEMPORARILY	Moved Temporarily
303	SEE_OTHER	See Other
304	NOT_MODIFIED	Not Modified
305	USE_PROXY	Use Proxy
307	TEMPORARY_REDIRECT	Temporary Redirect
308	PERMANENT_REDIRECT	Permanent Redirect
400	BAD_REQUEST	Bad Request
401	UNAUTHORIZED	Unauthorized
402	PAYMENT_REQUIRED	Payment Required
403	FORBIDDEN	Forbidden
404	NOT_FOUND	Not Found
405	METHOD_NOT_ALLOWED	Method Not Allowed
406	NOT_ACCEPTABLE	Not Acceptable
407	PROXY_AUTHENTICATION_REQUIRED	Proxy Authentication Required
408	REQUEST_TIMEOUT	Request Timeout
409	CONFLICT	Conflict
410	GONE	Gone
411	LENGTH_REQUIRED	Length Required
412	PRECONDITION_FAILED	Precondition Failed
413	REQUEST_TOO_LONG	Request Entity Too Large
414	REQUEST_URI_TOO_LONG	Request-URI Too Long
415	UNSUPPORTED_MEDIA_TYPE	Unsupported Media Type
416	REQUESTED_RANGE_NOT_SATISFIABLE	Requested Range Not Satisfiable
417	EXPECTATION_FAILED	Expectation Failed
418	IM_A_TEAPOT	I'm a teapot
419	INSUFFICIENT_SPACE_ON_RESOURCE	Insufficient Space on Resource
420	METHOD_FAILURE	Method Failure
421	MISDIRECTED_REQUEST	Misdirected Request
422	UNPROCESSABLE_ENTITY	Unprocessable Entity
423	LOCKED	Locked
424	FAILED_DEPENDENCY	Failed Dependency
426	UPGRADE_REQUIRED	Upgrade Required
428	PRECONDITION_REQUIRED	Precondition Required
429	TOO_MANY_REQUESTS	Too Many Requests
431	REQUEST_HEADER_FIELDS_TOO_LARGE	Request Header Fields Too Large
451	UNAVAILABLE_FOR_LEGAL_REASONS	Unavailable For Legal Reasons
500	INTERNAL_SERVER_ERROR	Internal Server Error
501	NOT_IMPLEMENTED	Not Implemented
502	BAD_GATEWAY	Bad Gateway
503	SERVICE_UNAVAILABLE	Service Unavailable
504	GATEWAY_TIMEOUT	Gateway Timeout
505	HTTP_VERSION_NOT_SUPPORTED	HTTP Version Not Supported
507	INSUFFICIENT_STORAGE	Insufficient Storage
511	NETWORK_AUTHENTICATION_REQUIRED	Network Authentication Required

Migrating from v1.x.x

http-status-codes v2 is mostly backwards compatible with v1. There is a single breaking change and two recommended changes.

[Breaking Change] 'Server Error'

The reason phrase for the status code 500 has been changed from "Server Error" to "Internal Server Error". This is the correct phrase according to RFC7231. If you are migrating from v1, and have code that relies on the result of getStatusText(500) or getReasonPhrase('Server Error'), then this could affect you.

[Non-breaking change] getStatusText renamed getReasonPhrase

The function getStatusText has been renamed to getReasonPhrase. The old function is still available, but may be deprecated in a future version. To fix this simply rename instances of getStatusText() to getReasonPhrase(). The function is otherwise the same as it was before.

[Non-breaking change] StatusCodes

In http-status-codes v1, Status Codes were exported directly from the top-level module. i.e. HttpStatus.OK. In v2 all Status Codes live under an object called StatusCodes. i.e. HttpStatus.StatusCodes.OK. We made this change to cater to TypeScript users who prefer a dedicated value with an enum type. The previous values are still exported, but we won't continue to update them. Please migrate if you're using the old-style imports.

Proposing a new status code

If you'd like to propose a new status code, feel free to update "codes.json" with the necessary information and open a pull request. There is no need to modify source code or even this README. This is done automatically by npm run update-codes.

In general, we try to include only codes that have an official RFC and have been approved, however exceptions can be made if the code is already in widespread use in the wild.

Steps to build and publish

1npm run update-codes
2npm run test
3npm run build
4npm version [major | minor | patch]
5npm publish

After releasing, please add release notes via GitHub Releases.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.7

/10

Last Scanned on 2025-05-05

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More