|  |
|  |
| |
| # 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. |
| |
| ## License |
| |
| MIT. |
| See [LICENSE.md](LICENSE.md) |
