source: trip-planner-front/node_modules/http-parser-js/README.md@ 76712b2

Last change on this file since 76712b2 was 6a3a178, checked in by Ema <ema_spirova@…>, 3 years ago

initial commit

  • Property mode set to 100644
File size: 1.3 KB
Line 
1# HTTP Parser
2
3This library parses HTTP protocol for requests and responses. It was created to replace `http_parser.c` since calling C++ function 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.
4
5This is packaged as a standalone npm module. To use in node, monkeypatch HTTPParser.
6
7```js
8// Monkey patch before you require http for the first time.
9process.binding('http_parser').HTTPParser = require('http-parser-js').HTTPParser;
10
11var http = require('http');
12// ...
13```
14
15## Testing
16
17Simply do `npm test`. The tests are copied from node and mscedex/io.js, with some modifcations.
18
19## Status
20
21This 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.
22
23### Node Versions
24
25`http-parser-js` should work via monkey-patching on Node v6-v11, and v13.
26
27Node 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.
28
29## License
30
31MIT. See LICENSE.md
Note: See TracBrowser for help on using the repository browser.