HTTP/2, the Twitter API, and Node

10 Oct 2017

Update 2017-01-04: Twitter has announced an update to HTTP/2 support in the API so the Accept-Encoding header is honored, and the workaround below is no longer required. However, you may want to do it anyhow in order to reduce your bandwidth needs when talking to the Twitter API. By default, Twitter will not compress responses.

HTTP/2 is a major revision of the HTTP protocol, most notable for multiplexing requests across a single TCP connection. Twitter was an early supporter of HTTP/2 and its predecessor SPDY. Now that HTTP/2 is going to be natively supported in Node 8, I wanted to use it in Block Together to make more efficient use of resources.

Unfortunately, the Twitter API servers implement an earlier draft of HTTP/2. Originally, client support for gzip and deflate was mandatory, so Twitter could send deflated content even if the client did not send Accept-Encoding: deflate. That requirement was removed in a later draft, so many clients, including Node's http2 package, don't support deflate natively. In order to use Node's HTTP/2 with Twitter, you'll need to add a little intermediate layer to deflate or gunzip:

const http2 = require('http2');
const zlib = require('zlib');
const client = http2.connect('');
const req = client.request({
  'accept-encoding': 'gzip,deflate',
  ':path': '/robots.txt'

let data = []
let expander = input => input;
req.on('response', response => {
  switch (response['content-encoding']) {
    case 'deflate':
      expander = zlib.inflateSync; break;
    case 'gzip':
      expander = zlib.gunzipSync; break;
req.on('data', d => data.push(d))
req.on('end', (r) => {
  var buffer = Buffer.concat(data);

Note that it's easy to mess up the encoding by converting the data chunks to strings too early using the wrong encoding. When you do that, the binary data can get interpreted as UTF-8 and mangled.

To really use the Twitter API, of course, you'll need to use an OAuth library. I've forked the node-oauth package and have an http2 branch that implements the deflation code above. You can use it by adding a line like this to your package.json:

    "oauth": "git://",

The upstream maintainer of node-oauth does not appear to be taking pull requests, so this probably won't be upstreamed. And I don't intend to actively maintain this branch other than for my own use, so consider this more along the lines of example code than a package ready to be used.

The issue with Twitter and Content-Encoding: deflate has also been noticed and fixed by Go.