diff --git a/doc/api/http2.md b/doc/api/http2.md index f30228c92373b1..e76c4e54608e7f 100644 --- a/doc/api/http2.md +++ b/doc/api/http2.md @@ -24,8 +24,11 @@ be emitted either by client-side code or server-side code. ### Server-side example -The following illustrates a simple, plain-text HTTP/2 server using the -Core API: +The following illustrates a simple HTTP/2 server using the Core API. +Since there are no browsers known that support +[unencrypted HTTP/2][HTTP/2 Unencrypted], the use of +[`http2.createSecureServer()`][] is necessary when communicating +with browser clients. ```js const http2 = require('http2'); @@ -253,7 +256,7 @@ and would instead register a handler for the `'stream'` event emitted by the ```js const http2 = require('http2'); -// Create a plain-text HTTP/2 server +// Create an unencrypted HTTP/2 server const server = http2.createServer(); server.on('stream', (stream, headers) => { @@ -1735,10 +1738,18 @@ changes: Returns a `net.Server` instance that creates and manages `Http2Session` instances. +Since there are no browsers known that support +[unencrypted HTTP/2][HTTP/2 Unencrypted], the use of +[`http2.createSecureServer()`][] is necessary when communicating +with browser clients. + ```js const http2 = require('http2'); -// Create a plain-text HTTP/2 server +// Create an unencrypted HTTP/2 server. +// Since there are no browsers known that support +// unencrypted HTTP/2, the use of `http2.createSecureServer()` +// is necessary when communicating with browser clients. const server = http2.createServer(); server.on('stream', (stream, headers) => { @@ -3093,6 +3104,7 @@ following additional properties: [Compatibility API]: #http2_compatibility_api [HTTP/1]: http.html [HTTP/2]: https://tools.ietf.org/html/rfc7540 +[HTTP/2 Unencrypted]: https://http2.github.io/faq/#does-http2-require-encryption [HTTP2 Headers Object]: #http2_headers_object [HTTP2 Settings Object]: #http2_settings_object [HTTPS]: https.html