# http-parser-js

> A pure JS HTTP parser for node.

Latest version **0.5.10** (published 2025-04-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install http-parser-js
pnpm add http-parser-js
yarn add http-parser-js
bun add http-parser-js
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.5.10 |
| Published | 2025-04-08 |
| First published | 2012-07-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 25.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 247 |
| Author | Tim Caswell |
| Maintainers | creationix, jimbly |
| Keywords | http |

## Links

- npm: https://www.npmjs.com/package/http-parser-js
- Repository: https://github.com/creationix/http-parser-js
- Homepage: https://github.com/creationix/http-parser-js#readme
- Issues: https://github.com/creationix/http-parser-js/issues
- npm.io page: https://npm.io/package/http-parser-js

## Recent versions

- 0.5.10 (latest) — 2025-04-08
- 0.5.9 — 2025-01-09
- 0.5.8 — 2022-06-27
- 0.5.7 — 2022-06-23
- 0.5.6 — 2022-03-06
- 0.5.5 — 2021-11-27
- 0.5.4 — 2021-11-26
- 0.5.3 — 2021-01-01
- 0.5.2 — 2019-11-02
- 0.5.1 — 2019-06-14
- 0.5.0 — 2018-10-22
- 0.4.13 — 2018-05-21
- 0.4.12 — 2018-04-24
- 0.4.11 — 2018-03-08
- 0.4.10 — 2018-02-03
- … 17 more at https://npm.io/package/http-parser-js/versions

## README

![Node](https://github.com/creationix/http-parser-js/workflows/Node/badge.svg)
![Node-v12](https://github.com/creationix/http-parser-js/workflows/Node-v12/badge.svg)

# HTTP Parser

This library parses HTTP protocol for requests and responses.
It was created to replace `http_parser.c` since calling C++ functions from JS is really slow in V8.
However, it is now primarily useful in having a more flexible/tolerant HTTP parser when dealing with legacy services that do not meet the strict HTTP parsing rules Node's parser follows.

This is packaged as a standalone npm module.
To use in node, monkeypatch HTTPParser.

```js
// Monkey patch before you require http for the first time.
process.binding('http_parser').HTTPParser = require('http-parser-js').HTTPParser;

var http = require('http');
// ...
```

## Testing

Simply run `npm test`.
The tests are copied from node and mscedex/io.js, with some modifcations.

## Status

This should now be usable in any node application, it now supports (nearly) everything `http_parser.c` does while still being tolerant with corrupted headers, and other kinds of malformed data.

### Node versions

`http-parser-js` should work via monkey-patching on Node v6-v11, and v13-14.

Node v12.x renamed the internal http parser, and did not expose it for monkey-patching, so to be able to monkey-patch on Node v12, you must run `node --http-parser=legacy file.js` to opt in to the old, monkey-patchable http_parser binding.

## Standalone usage

While this module is intended to be used as a replacement for the internal Node.js parser, it can be used as a standalone parser. The [`standalone-example.js`](standalone-example.js) demonstrates how to use the somewhat awkward API (coming from compatibility with the Node.js internals) to parse HTTP from raw Buffers.

## License

MIT.
See [LICENSE.md](LICENSE.md)

---
_Source: https://npm.io/package/http-parser-js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._