1
0
Fork 0
management/front/dkha-web-sz-main/node_modules/http-parser-js/README.md

44 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2024-01-16 21:26:16 +08:00
![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)
2023-12-18 13:12:25 +08:00
2024-01-16 21:26:16 +08:00
# HTTP Parser
2023-12-18 13:12:25 +08:00
2024-01-16 21:26:16 +08:00
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.
2023-12-18 13:12:25 +08:00
2024-01-16 21:26:16 +08:00
This is packaged as a standalone npm module.
To use in node, monkeypatch HTTPParser.
2023-12-18 13:12:25 +08:00
```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
2024-01-16 21:26:16 +08:00
Simply run `npm test`.
The tests are copied from node and mscedex/io.js, with some modifcations.
2023-12-18 13:12:25 +08:00
## Status
2024-01-16 21:26:16 +08:00
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.
2023-12-18 13:12:25 +08:00
## License
2024-01-16 21:26:16 +08:00
MIT.
See [LICENSE.md](LICENSE.md)