npmpackage.info

Gathering detailed insights and metrics for http-errors

Other packages similar to http-errors

@types/http-errors

2.0.5

TypeScript definitions for http-errors

restify-errors

8.0.2

Collection of Error objects shared across restify components.

http-errors-enhanced

3.0.2

Create HTTP errors with additional properties for any framework.

fastify-http-errors-enhanced

6.0.1

A error handling plugin for Fastify that uses enhanced HTTP errors.

Gathering detailed insights and metrics for http-errors

http-errors - 2.0.0 | npmpackage.info

http-errors

Create HTTP Errors

2.0.0

1,531

MIT

JavaScript

2.40 kB

14,468,997,020 7.7

Installations

npm install http-errors

Developer Guide

BETA

Typescript

No

Module System

N/A

Min. Node Version

>= 0.8

Node Version

16.7.0

NPM Version

7.20.3 Score

99.1

Supply Chain

99.5

Quality

80.5

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

10

Total

63

Closed

28

Merged

25

Issues

Open

6

Total

45

Closed

39

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

jshttp

Download Statistics

Total Downloads

14,468,997,020

Last Day

3,666,296

Last Week

63,959,543

Last Month

279,303,760

Last Year

2,924,375,590

GitHub Statistics

MIT License

1,531 Stars

308 Commits

116 Forks

25 Watchers

7 Branches

36 Contributors

Updated on Jul 03, 2025

Bundle Size

6.14 kB

Minified

2.40 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 36 Contributors

Package Meta Information

Latest Version

2.0.0

Package Id

http-errors@2.0.0

Unpacked Size

18.37 kB

Size

6.19 kB

File Count

NPM Version

7.20.3

Node Version

16.7.0

Published on

Dec 18, 2021

Total Downloads

Cumulative downloads

Total Downloads

14,468,997,020

Last Day

-6.4%

3,666,296

Compared to previous day

Last Week

-7.9%

63,959,543

Compared to previous week

Last Month

279,303,760

Compared to previous month

Last Year

8.9%

2,924,375,590

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

depd inherits setprototypeof statuses toidentifier

Dev Dependencies

eslint eslint-config-standard eslint-plugin-import eslint-plugin-markdown eslint-plugin-node eslint-plugin-promise eslint-plugin-standard mocha nyc

http-errors

Create HTTP errors for Express, Koa, Connect, etc. with ease.

Install

This is a Node.js module available through the npm registry. Installation is done using the npm install command:

1$ npm install http-errors

Example

1var createError = require('http-errors')
2var express = require('express')
3var app = express()
4
5app.use(function (req, res, next) {
6  if (!req.user) return next(createError(401, 'Please login to view this page.'))
7  next()
8})

API

This is the current API, currently extracted from Koa and subject to change.

Error Properties

expose - can be used to signal if message should be sent to the client, defaulting to false when status >= 500
headers - can be an object of header names to values to be sent to the client, defaulting to undefined. When defined, the key names should all be lower-cased
message - the traditional error message, which should be kept short and all single line
status - the status code of the error, mirroring statusCode for general compatibility
statusCode - the status code of the error, defaulting to 500

createError([status], [message], [properties])

Create a new error object with the given message msg. The error object inherits from createError.HttpError.

1var err = createError(404, 'This video does not exist!')

status: 500 - the status code as a number
message - the message of the error, defaulting to node's text for that status code.
properties - custom properties to attach to the object

createError([status], [error], [properties])

Extend the given error object with createError.HttpError properties. This will not alter the inheritance of the given error object, and the modified error object is the return value.

1fs.readFile('foo.txt', function (err, buf) {
2  if (err) {
3    if (err.code === 'ENOENT') {
4      var httpError = createError(404, err, { expose: false })
5    } else {
6      var httpError = createError(500, err)
7    }
8  }
9})

status - the status code as a number
error - the error object to extend
properties - custom properties to attach to the object

createError.isHttpError(val)

Determine if the provided val is an HttpError. This will return true if the error inherits from the HttpError constructor of this module or matches the "duck type" for an error this module creates. All outputs from the createError factory will return true for this function, including if an non-HttpError was passed into the factory.

new createError[code || name]([msg]))

Create a new error object with the given message msg. The error object inherits from createError.HttpError.

1var err = new createError.NotFound()

code - the status code as a number
name - the name of the error as a "bumpy case", i.e. NotFound or InternalServerError.

List of all constructors

Status Code	Constructor Name
400	BadRequest
401	Unauthorized
402	PaymentRequired
403	Forbidden
404	NotFound
405	MethodNotAllowed
406	NotAcceptable
407	ProxyAuthenticationRequired
408	RequestTimeout
409	Conflict
410	Gone
411	LengthRequired
412	PreconditionFailed
413	PayloadTooLarge
414	URITooLong
415	UnsupportedMediaType
416	RangeNotSatisfiable
417	ExpectationFailed
418	ImATeapot
421	MisdirectedRequest
422	UnprocessableEntity
423	Locked
424	FailedDependency
425	TooEarly
426	UpgradeRequired
428	PreconditionRequired
429	TooManyRequests
431	RequestHeaderFieldsTooLarge
451	UnavailableForLegalReasons
500	InternalServerError
501	NotImplemented
502	BadGateway
503	ServiceUnavailable
504	GatewayTimeout
505	HTTPVersionNotSupported
506	VariantAlsoNegotiates
507	InsufficientStorage
508	LoopDetected
509	BandwidthLimitExceeded
510	NotExtended
511	NetworkAuthenticationRequired

License

MIT

No vulnerabilities found.

10

Dependency-Update-Tool

Determines if the project uses a dependency update tool.

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

Token-Permissions

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

10

License

Determines if the project has defined a license.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

Contributors

Determines if the project has a set of contributors from multiple organizations (e.g., companies).

9

Security-Policy

Determines if the project has published a security policy.

8

Maintained

Determines if the project is "actively maintained".

8

CI-Tests

Determines if the project runs tests before pull requests are merged.

7

SAST

Determines if the project uses static code analysis.

6

Code-Review

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

6

Pinned-Dependencies

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

4

Branch-Protection

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

0

CII-Best-Practices

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

0

Fuzzing

Determines if the project uses fuzzing.

Score

7.7

/10

Last Scanned on 2025-06-30T21:30:27Z

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