parse-raw-http

Parse a response

1const {parseResponse} = require('parse-raw-http');
2
3const data = new Buffer([
4  'HTTP/1.1 200 OK\r\n',
5  'Content-Type: text/plain; charset=utf-8\r\n',
6  'Transfer-Encoding: chunked\r\n',
7  '\r\n',
8  '4\r\n',  'Foo\n',
9  '1a\r\n', 'Chunk with 1a=16+10 bytes\n',
10].join(''), 'utf8');
11
12const res = parseResponse(data, {
13  decodeContentEncoding: true,
14});
15
16// Response object:
17res.statusCode      // 200
18res.statusMessage   // 'OK'
19res.headers         // {'content-type': '...', ...}
20res.bodyData        // Buffer: decoded response body

Why do all of the options always need to be specified?

• "Explicit is better than implicit" and "In the face of ambiguity, refuse the temptation to guess"

• I think the aspects involved must not be unknown unknowns for you if you're parsing raw HTTP. You need to know these aspects exist and explicitly decide what you want.

How comprehensive are the tests?

They're a start. Pull requests welcome.

Before changing the major semver from 0, we'll also be testing on a massive subset of the Common Crawl WARC files, with the results cross-checked with those of running nodejs's HTTP C library on the same input.

Other HTTP-parsing libraries

• nodejs/http-parser

• creationix/http-parser-js

• AlexanderMac/http-request-parser

• apiaryio/http-string-parser

• for-GET/api-pegjs

License: MIT