http-enums

library1.0.5jsnpmunverified

http-enums is a utility library providing standardized JavaScript and TypeScript enumerations for common HTTP concepts, including status codes, request methods, and frequently used request and response headers. As of version 1.0.5, last published approximately three years ago (around January 2020), it offers a straightforward and type-safe way to reference these constants, aiming to reduce the use of 'magic strings' in web development projects. Due to its static nature as a collection of constants, it generally does not require frequent updates; however, the lack of recent maintenance means it may not incorporate the latest HTTP specification changes or benefit from community-driven improvements. It differentiates itself by its singular focus on providing comprehensive HTTP enums, suitable for both client-side and server-side applications where explicit constant definitions enhance code clarity.

http-networking serialization

npm install http-enums

package ↗

INSTALL

IMPORT

SIG · HTTP-ENUMS

http-enums

http-networkingjavascriptv1.0.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

HttpStatus

✓ import { HttpStatus } from 'http-enums';

✗ const HttpStatus = require('http-enums').HttpStatus;

This library ships with TypeScript types and is primarily designed for ESM-style named imports. CommonJS `require` works but is not idiomatic.

HttpMethod

✓ import { HttpMethod } from 'http-enums';

✗ import HttpMethod from 'http-enums';

Only named exports are provided for individual enum collections; default imports will fail.

HttpRequestHeaders, HttpResponseHeaders

✓ import { HttpRequestHeaders, HttpResponseHeaders } from 'http-enums';

✗ import * as HttpEnums from 'http-enums';

While `import * as HttpEnums from 'http-enums'` would import all exports, it's generally better practice to import specific symbols for clarity and tree-shaking.

Demonstrates importing various HTTP enumerations (status, method, request/response headers) and using their values in a TypeScript function.

import { HttpStatus, HttpMethod, HttpRequestHeaders, HttpResponseHeaders } from 'http-enums'; function handleRequest(method: HttpMethod, status: HttpStatus, headers: Record<string, string>): void { console.log(`Received ${method} request with status ${status}.`); if (method === HttpMethod.GET) { console.log('This is a GET request.'); } if (status === HttpStatus.NOT_FOUND) { console.log('Resource not found.'); } if (headers[HttpRequestHeaders.ACCEPT_LANGUAGE] === 'en-US') { console.log('Client prefers US English.'); } console.log(`Setting Content-Type to: ${HttpResponseHeaders.CONTENT_TYPE_APPLICATION_JSON}`); } handleRequest(HttpMethod.POST, HttpStatus.CREATED, { 'accept-language': 'en-US', [HttpRequestHeaders.CONTENT_TYPE]: 'application/json' }); handleRequest(HttpMethod.GET, HttpStatus.OK, { 'user-agent': 'MyBrowser/1.0' });

Debug

Known issues

gotchaThe `http-enums` package has not been updated in approximately three years (since January 2020). While HTTP standards are relatively stable, this means it may not include very recent additions or clarifications to HTTP status codes, methods, or headers. Consider this if working with cutting-edge HTTP specifications.

fix

For projects requiring the absolute latest HTTP specification accuracy or active maintenance, consider alternative, more recently updated HTTP utility libraries or defining custom enums.

affects: >=1.0.5

gotchaHeader names in HTTP are case-insensitive by standard, but JavaScript string comparisons are case-sensitive. While `HttpRequestHeaders` and `HttpResponseHeaders` provide canonical names, always normalize incoming header keys (e.g., to lowercase) before direct comparison if they come from external sources like `req.headers` in Node.js.

fix

When comparing against actual HTTP header values, convert the incoming header key to lowercase: `const incomingHeaders = { 'Content-Type': 'application/json' }; if (incomingHeaders['content-type'] === 'application/json') { /* ... */ }`.

affects: >=1.0.0

gotchaAttempting to use `require` to import individual named exports directly (e.g., `const { HttpStatus } = require('http-enums');`) might lead to `undefined` or runtime errors in some CommonJS environments, especially if the package's `package.json` specifies `"type": "module"` or uses only ESM syntax internally.

fix

For CommonJS, it is generally safer to `const HttpEnums = require('http-enums');` and then access properties like `HttpEnums.HttpStatus`. However, for modern TypeScript/JavaScript projects, stick to `import { HttpStatus } from 'http-enums';`.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: Cannot read properties of undefined (reading 'GET')

Attempting to access an enum member (e.g., `HttpMethod.GET`) when the enum object itself (`HttpMethod`) was not correctly imported or is `undefined`.

fix

Ensure you are using named imports correctly: `import { HttpMethod } from 'http-enums';`. If using CommonJS, verify the `require` statement loads the module correctly before accessing its properties.

TS2305: Module '"http-enums"' has no exported member 'MyCustomEnum'.

Trying to import an enum symbol that does not exist or has been renamed in the `http-enums` package.

fix

Double-check the available exports from the `http-enums` package. Common exports are `HttpStatus`, `HttpMethod`, `HttpRequestHeaders`, and `HttpResponseHeaders`. Ensure correct casing.

ReferenceError: HttpStatus is not defined

Using an enum like `HttpStatus` without first importing it into the current file scope.

fix

Add the necessary import statement at the top of your file: `import { HttpStatus } from 'http-enums';`.

Upgrade

Version history

1.0.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Amazon

Resources

packagehttps://www.npmjs.com/package/http-enums ↗