The Compatibility API has the goal of providing a similar developer experience of HTTP/1 when using HTTP/2, making it possible to develop applications that support both [HTTP/1][] and HTTP/2. This API targets only the public API of the [HTTP/1][]. However many modules use internal methods or state, and those are not supported as it is a completely different implementation.

    The following example creates an HTTP/2 server using the compatibility API:

    1. const http2 = require('http2');
    2. const server = http2.createServer((req, res) => {
    3.   res.setHeader('Content-Type', 'text/html');
    4.   res.setHeader('X-Foo', 'bar');
    5.   res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
    6.   res.end('ok');
    7. });

    In order to create a mixed [HTTPS][] and HTTP/2 server, refer to the [ALPN negotiation][] section. Upgrading from non-tls HTTP/1 servers is not supported.

    The HTTP/2 compatibility API is composed of [Http2ServerRequest][] and [Http2ServerResponse][]. They aim at API compatibility with HTTP/1, but they do not hide the differences between the protocols. As an example, the status message for HTTP codes is ignored.