From 52a0d97187f92579676dce54e05724606374c2fc Mon Sep 17 00:00:00 2001 From: Gil Tayar Date: Mon, 7 Aug 2017 19:46:07 +0300 Subject: [PATCH] doc: explain browser support of http/2 without SSL Since browser support HTTP/2 only using SSL, the basic example given in the docs won't work if the client is a browser. Added a note to documentation explaining this and how to change the code to make browser support it. PR-URL: https://github.com/nodejs/node/pull/14670 Reviewed-By: James M Snell Reviewed-By: Anna Henningsen Reviewed-By: Benjamin Gruenbaum --- doc/api/http2.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/api/http2.md b/doc/api/http2.md index 148c9f2ec3..c1264c403d 100755 --- a/doc/api/http2.md +++ b/doc/api/http2.md @@ -39,6 +39,12 @@ server.on('stream', (stream, headers) => { server.listen(80); ``` +Note that the above example is an HTTP/2 server that does not support SSL. +This is significant as most browsers support HTTP/2 only with SSL. +To make the above server be able to serve content to browsers, +replace `http2.createServer()` with +`http2.createSecureServer({key: /* your SSL key */, cert: /* your SSL cert */})`. + The following illustrates an HTTP/2 client: ```js