<!DOCTYPE html><html lang="en"><head>

<meta charset="utf-8">

<meta name="viewport" content="width=device-width">

<title>HTTP/2 | Node.js v12.10.0 Documentation</title>

<link rel="stylesheet" href="data:text/css;base64,LyogbGF0aW4tZXh0ICovCkBmb250LWZhY2UgewogIGZvbnQtZmFtaWx5OiAnTGF0byc7CiAgZm9udC1zdHlsZTogaXRhbGljOwogIGZvbnQtd2VpZ2h0OiA0MDA7CiAgc3JjOiBsb2NhbCgnTGF0byBJdGFsaWMnKSwgbG9jYWwoJ0xhdG8tSXRhbGljJyksIHVybChodHRwczovL2ZvbnRzLmdzdGF0aWMuY29tL3MvbGF0by92MTYvUzZ1OHc0Qk1VVFBIanhzQVVpLXFOaVhnN2VVMC53b2ZmMikgZm9ybWF0KCd3b2ZmMicpOwogIHVuaWNvZGUtcmFuZ2U6IFUrMDEwMC0wMjRGLCBVKzAyNTksIFUrMUUwMC0xRUZGLCBVKzIwMjAsIFUrMjBBMC0yMEFCLCBVKzIwQUQtMjBDRiwgVSsyMTEzLCBVKzJDNjAtMkM3RiwgVStBNzIwLUE3RkY7Cn0KLyogbGF0aW4gKi8KQGZvbnQtZmFjZSB7CiAgZm9udC1mYW1pbHk6ICdMYXRvJzsKICBmb250LXN0eWxlOiBpdGFsaWM7CiAgZm9udC13ZWlnaHQ6IDQwMDsKICBzcmM6IGxvY2FsKCdMYXRvIEl0YWxpYycpLCBsb2NhbCgnTGF0by1JdGFsaWMnKSwgdXJsKGh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9sYXRvL3YxNi9TNnU4dzRCTVVUUEhqeHNBWEMtcU5pWGc3US53b2ZmMikgZm9ybWF0KCd3b2ZmMicpOwogIHVuaWNvZGUtcmFuZ2U6IFUrMDAwMC0wMEZGLCBVKzAxMzEsIFUrMDE1Mi0wMTUzLCBVKzAyQkItMDJCQywgVSswMkM2LCBVKzAyREEsIFUrMDJEQywgVSsyMDAwLTIwNkYsIFUrMjA3NCwgVSsyMEFDLCBVKzIxMjIsIFUrMjE5MSwgVSsyMTkzLCBVKzIyMTIsIFUrMjIxNSwgVStGRUZGLCBVK0ZGRkQ7Cn0KLyogbGF0aW4tZXh0ICovCkBmb250LWZhY2UgewogIGZvbnQtZmFtaWx5OiAnTGF0byc7CiAgZm9udC1zdHlsZTogbm9ybWFsOwogIGZvbnQtd2VpZ2h0OiA0MDA7CiAgc3JjOiBsb2NhbCgnTGF0byBSZWd1bGFyJyksIGxvY2FsKCdMYXRvLVJlZ3VsYXInKSwgdXJsKGh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9sYXRvL3YxNi9TNnV5dzRCTVVUUEhqeEF3WGlXdEZDZlE3QS53b2ZmMikgZm9ybWF0KCd3b2ZmMicpOwogIHVuaWNvZGUtcmFuZ2U6IFUrMDEwMC0wMjRGLCBVKzAyNTksIFUrMUUwMC0xRUZGLCBVKzIwMjAsIFUrMjBBMC0yMEFCLCBVKzIwQUQtMjBDRiwgVSsyMTEzLCBVKzJDNjAtMkM3RiwgVStBNzIwLUE3RkY7Cn0KLyogbGF0aW4gKi8KQGZvbnQtZmFjZSB7CiAgZm9udC1mYW1pbHk6ICdMYXRvJzsKICBmb250LXN0eWxlOiBub3JtYWw7CiAgZm9udC13ZWlnaHQ6IDQwMDsKICBzcmM6IGxvY2FsKCdMYXRvIFJlZ3VsYXInKSwgbG9jYWwoJ0xhdG8tUmVndWxhcicpLCB1cmwoaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL2xhdG8vdjE2L1M2dXl3NEJNVVRQSGp4NHdYaVd0RkNjLndvZmYyKSBmb3JtYXQoJ3dvZmYyJyk7CiAgdW5pY29kZS1yYW5nZTogVSswMDAwLTAwRkYsIFUrMDEzMSwgVSswMTUyLTAxNTMsIFUrMDJCQi0wMkJDLCBVKzAyQzYsIFUrMDJEQSwgVSswMkRDLCBVKzIwMDAtMjA2RiwgVSsyMDc0LCBVKzIwQUMsIFUrMjEyMiwgVSsyMTkxLCBVKzIxOTMsIFUrMjIxMiwgVSsyMjE1LCBVK0ZFRkYsIFUrRkZGRDsKfQovKiBsYXRpbi1leHQgKi8KQGZvbnQtZmFjZSB7CiAgZm9udC1mYW1pbHk6ICdMYXRvJzsKICBmb250LXN0eWxlOiBub3JtYWw7CiAgZm9udC13ZWlnaHQ6IDcwMDsKICBzcmM6IGxvY2FsKCdMYXRvIEJvbGQnKSwgbG9jYWwoJ0xhdG8tQm9sZCcpLCB1cmwoaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL2xhdG8vdjE2L1M2dTl3NEJNVVRQSGg2VVZTd2FQR1EzcTVkME43dy53b2ZmMikgZm9ybWF0KCd3b2ZmMicpOwogIHVuaWNvZGUtcmFuZ2U6IFUrMDEwMC0wMjRGLCBVKzAyNTksIFUrMUUwMC0xRUZGLCBVKzIwMjAsIFUrMjBBMC0yMEFCLCBVKzIwQUQtMjBDRiwgVSsyMTEzLCBVKzJDNjAtMkM3RiwgVStBNzIwLUE3RkY7Cn0KLyogbGF0aW4gKi8KQGZvbnQtZmFjZSB7CiAgZm9udC1mYW1pbHk6ICdMYXRvJzsKICBmb250LXN0eWxlOiBub3JtYWw7CiAgZm9udC13ZWlnaHQ6IDcwMDsKICBzcmM6IGxvY2FsKCdMYXRvIEJvbGQnKSwgbG9jYWwoJ0xhdG8tQm9sZCcpLCB1cmwoaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL2xhdG8vdjE2L1M2dTl3NEJNVVRQSGg2VVZTd2lQR1EzcTVkMC53b2ZmMikgZm9ybWF0KCd3b2ZmMicpOwogIHVuaWNvZGUtcmFuZ2U6IFUrMDAwMC0wMEZGLCBVKzAxMzEsIFUrMDE1Mi0wMTUzLCBVKzAyQkItMDJCQywgVSswMkM2LCBVKzAyREEsIFUrMDJEQywgVSsyMDAwLTIwNkYsIFUrMjA3NCwgVSsyMEFDLCBVKzIxMjIsIFUrMjE5MSwgVSsyMTkzLCBVKzIyMTIsIFUrMjIxNSwgVStGRUZGLCBVK0ZGRkQ7Cn0K">

<link rel="stylesheet" href="data:text/css;base64,LyotLS0tLS0tLS0tLS0tLS0tLS0tLS0gTGF5b3V0IGFuZCBUeXBvZ3JhcGh5IC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0qLwpodG1sIHsKICBmb250LXNpemU6IDFyZW07CiAgb3ZlcmZsb3ctd3JhcDogYnJlYWstd29yZDsKICAtd2Via2l0LWZvbnQtc21vb3RoaW5nOiBhbnRpYWxpYXNlZDsKICAtbW96LW9zeC1mb250LXNtb290aGluZzogZ3JheXNjYWxlOwogIC13ZWJraXQtZm9udC12YXJpYW50LWxpZ2F0dXJlczogbm9uZTsKICAgICAgICAgIGZvbnQtdmFyaWFudC1saWdhdHVyZXM6IG5vbmU7Cn0KCiogewogIGJveC1zaXppbmc6IGJvcmRlci1ib3g7Cn0KCmJvZHkgewogIGZvbnQtZmFtaWx5OiAiTGF0byIsICJMdWNpZGEgR3JhbmRlIiwgIkx1Y2lkYSBTYW5zIFVuaWNvZGUiLCAiTHVjaWRhIFNhbnMiLCBWZXJkYW5hLCBUYWhvbWEsIHNhbnMtc2VyaWY7CiAgbWFyZ2luOiAwOwogIHBhZGRpbmc6IDA7CiAgY29sb3I6ICMzMzM7CiAgYmFja2dyb3VuZDogI2ZmZjsKfQoKaDEgeyBmb250LXNpemU6IDIuNXJlbSB9CmgyIHsgZm9udC1zaXplOiAycmVtIH0KaDMgeyBmb250LXNpemU6IDEuNzVyZW0gfQpoNCB7IGZvbnQtc2l6ZTogMS41cmVtIH0KaDUgeyBmb250LXNpemU6IDEuMjVyZW0gfQpoNiB7IGZvbnQtc2l6ZTogMXJlbSB9CgpoMSwgaDIsIGgzLCBoNCwgaDUsIGg2IHsKICBtYXJnaW46IDEuNXJlbSAwIDFyZW07CiAgdGV4dC1yZW5kZXJpbmc6IG9wdGltaXplTGVnaWJpbGl0eTsKICBmb250LXdlaWdodDogNzAwOwogIHBvc2l0aW9uOiByZWxhdGl2ZTsKfQoKcHJlLCB0dCwgY29kZSwgLnByZSwgc3Bhbi50eXBlLCBhLnR5cGUgewogIGZvbnQtZmFtaWx5OiBTRk1vbm8tUmVndWxhciwgTWVubG8sIENvbnNvbGFzLCAiTGliZXJhdGlvbiBNb25vIiwgIkNvdXJpZXIgTmV3IiwgbW9ub3NwYWNlOwogIGZvbnQtc2l6ZTogLjllbTsKfQoKI2NvbnRlbnQgewogIHBvc2l0aW9uOiByZWxhdGl2ZTsKfQoKYSwgYTpsaW5rLCBhOmFjdGl2ZSB7CiAgY29sb3I6ICM0Mzg1M2Q7CiAgdGV4dC1kZWNvcmF0aW9uOiBub25lOwogIGJvcmRlci1yYWRpdXM6IDJweDsKICBwYWRkaW5nOiAxcHggM3B4Owp9CgphOmhvdmVyLCBhOmZvY3VzIHsKICBjb2xvcjogI2ZmZjsKICBiYWNrZ3JvdW5kLWNvbG9yOiAjNDM4NTNkOwogIG91dGxpbmU6IG5vbmU7Cn0KCnN0cm9uZyB7CiAgZm9udC13ZWlnaHQ6IDcwMDsKfQoKY29kZSBhOmhvdmVyIHsKICBiYWNrZ3JvdW5kOiBub25lOwp9CgplbSBjb2RlIHsKICBmb250LXN0eWxlOiBub3JtYWw7Cn0KCiNjaGFuZ2Vsb2cgI2d0b2MgewogIGRpc3BsYXk6IG5vbmU7Cn0KCiNndG9jIHsKICBtYXJnaW4tdG9wOiAuNXJlbTsKICBtYXJnaW4tYm90dG9tOiAxcmVtOwp9CgojZ3RvYyB1bCB7CiAgbGlzdC1zdHlsZTogbm9uZTsKICBtYXJnaW4tbGVmdDogMDsKICBsaW5lLWhlaWdodDogMS41cmVtOwp9CgojZ3RvYyA+IHVsID4gbGkgewogIGRpc3BsYXk6IGlubGluZTsKICBib3JkZXItcmlnaHQ6IDFweCAjMDAwIHNvbGlkOwogIG1hcmdpbi1yaWdodDogMC40cmVtOwogIHBhZGRpbmctcmlnaHQ6IDAuNHJlbTsKfQoKI2d0b2MgPiB1bCA+IGxpOmxhc3QtY2hpbGQgewogIGJvcmRlci1yaWdodDogbm9uZTsKICBtYXJnaW4tcmlnaHQ6IDA7CiAgcGFkZGluZy1yaWdodDogMDsKfQoKbGkudmVyc2lvbi1waWNrZXIgewogIHBvc2l0aW9uOiByZWxhdGl2ZTsKfQoKbGkudmVyc2lvbi1waWNrZXI6aG92ZXIgPiBhIHsKICBib3JkZXItcmFkaXVzOiAycHggMnB4IDAgMDsKfQoKbGkudmVyc2lvbi1waWNrZXI6aG92ZXIgPiBvbCB7CiAgZGlzcGxheTogYmxvY2s7CiAgei1pbmRleDogMTsKfQoKbGkudmVyc2lvbi1waWNrZXIgYSBzcGFuIHsKICBmb250LXNpemU6IC43cmVtOwp9CgpvbC52ZXJzaW9uLXBpY2tlciB7CiAgYmFja2dyb3VuZDogI2ZmZjsKICBib3JkZXI6IDFweCAjNDM4NTNkIHNvbGlkOwogIGJvcmRlci1yYWRpdXM6IDAgMCAycHggMnB4OwogIGRpc3BsYXk6IG5vbmU7CiAgbGlzdC1zdHlsZTogbm9uZTsKICBwb3NpdGlvbjogYWJzb2x1dGU7CiAgcmlnaHQ6IDA7CiAgdG9wOiAxLjI1cmVtOwogIHdpZHRoOiAxMDAlOwp9CgojZ3RvYyBvbC52ZXJzaW9uLXBpY2tlciBsaSB7CiAgZGlzcGxheTogYmxvY2s7CiAgYm9yZGVyLXJpZ2h0OiAwOwogIG1hcmdpbi1yaWdodDogMDsKfQoKb2wudmVyc2lvbi1waWNrZXIgbGkgYSB7CiAgYm9yZGVyLXJhZGl1czogMDsKICBkaXNwbGF5OiBibG9jazsKICBtYXJnaW46IDA7CiAgcGFkZGluZzogLjFyZW07CiAgcGFkZGluZy1sZWZ0OiAxcmVtOwp9CgpvbC52ZXJzaW9uLXBpY2tlciBsaTpsYXN0LWNoaWxkIGEgewogIGJvcmRlci1ib3R0b20tcmlnaHQtcmFkaXVzOiAxcHg7CiAgYm9yZGVyLWJvdHRvbS1sZWZ0LXJhZGl1czogMXB4Owp9CgoubGluZSB7CiAgd2lkdGg6IGNhbGMoMTAwJSAtIDFyZW0pOwogIGRpc3BsYXk6IGJsb2NrOwogIHBhZGRpbmctYm90dG9tOiAxcHg7Cn0KCi5hcGlfc3RhYmlsaXR5IHsKICBjb2xvcjogd2hpdGUgIWltcG9ydGFudDsKICBtYXJnaW46IDAgMCAxcmVtIDA7CiAgZm9udC1mYW1pbHk6ICJMYXRvIiwgIkx1Y2lkYSBHcmFuZGUiLCAiTHVjaWRhIFNhbnMgVW5pY29kZSIsICJMdWNpZGEgU2FucyIsIFZlcmRhbmEsIFRhaG9tYSwgc2Fucy1zZXJpZjsKICBwYWRkaW5nOiAxcmVtOwogIGxpbmUtaGVpZ2h0OiAxLjU7Cn0KCi5hcGlfc3RhYmlsaXR5ICogewogIGNvbG9yOiB3aGl0ZSAhaW1wb3J0YW50Owp9CgouYXBpX3N0YWJpbGl0eSBhIHsKICB0ZXh0LWRlY29yYXRpb246IHVuZGVybGluZTsKfQoKLmFwaV9zdGFiaWxpdHkgYTpob3ZlciwgLmFwaV9zdGFiaWxpdHkgYTphY3RpdmUsIC5hcGlfc3RhYmlsaXR5IGE6Zm9jdXMgewogIGJhY2tncm91bmQ6IHJnYmEoMjU1LCAyNTUsIDI1NSwgLjQpOwp9CgouYXBpX3N0YWJpbGl0eSBhIGNvZGUgewogIGJhY2tncm91bmQ6IG5vbmU7Cn0KCi5hcGlfc3RhYmlsaXR5XzAgewogIGJhY2tncm91bmQtY29sb3I6ICNENjAwMjc7Cn0KCi5hcGlfc3RhYmlsaXR5XzEgewogIGJhY2tncm91bmQtY29sb3I6ICNFQzUzMTU7Cn0KCi5hcGlfc3RhYmlsaXR5XzIgewogIGJhY2tncm91bmQtY29sb3I6ICM0RUJBMEY7Cn0KCi5hcGlfbWV0YWRhdGEgewogIGZvbnQtc2l6ZTogLjg1cmVtOwogIG1hcmdpbi1ib3R0b206IDFyZW07Cn0KCi5hcGlfbWV0YWRhdGEgc3BhbiB7CiAgbWFyZ2luLXJpZ2h0OiAxcmVtOwp9CgouYXBpX21ldGFkYXRhIHNwYW46bGFzdC1jaGlsZCB7CiAgbWFyZ2luLXJpZ2h0OiAwcHg7Cn0KCnVsLnBsYWluIHsKICBsaXN0LXN0eWxlOiBub25lOwp9CgphYmJyIHsKICBib3JkZXItYm90dG9tOiAxcHggZG90dGVkICM0NTQ1NDU7Cn0KCnAgewogIHRleHQtcmVuZGVyaW5nOiBvcHRpbWl6ZUxlZ2liaWxpdHk7CiAgbWFyZ2luOiAwIDAgMS4xMjVyZW0gMDsKICBsaW5lLWhlaWdodDogMS41Owp9CgojYXBpY29udGVudCA+ICo6bGFzdC1jaGlsZCB7CiAgbWFyZ2luLWJvdHRvbTogMDsKICBwYWRkaW5nLWJvdHRvbTogMnJlbTsKfQoKdGFibGUgewogIGJvcmRlci1jb2xsYXBzZTogY29sbGFwc2U7CiAgbWFyZ2luOiAwIDAgMS41cmVtIDA7Cn0KCnRoLCB0ZCB7CiAgYm9yZGVyOiAxcHggc29saWQgI2FhYTsKICBwYWRkaW5nOiAuNzVyZW0gMXJlbSAuNzVyZW0gMXJlbTsKICB2ZXJ0aWNhbC1hbGlnbjogdG9wOwp9Cgp0aCB7CiAgdGV4dC1hbGlnbjpsZWZ0Owp9CgpvbCwgdWwsIGRsIHsKICBtYXJnaW46IDAgMCAuNnJlbSAwOwogIHBhZGRpbmc6IDA7Cn0KCm9sIHVsLCBvbCBvbCwgb2wgZGwsIHVsIHVsLCB1bCBvbCwgdWwgZGwsIGRsIHVsLCBkbCBvbCwgZGwgZGwgewogIG1hcmdpbi1ib3R0b206IDA7Cn0KCnVsLCBvbCB7CiAgbWFyZ2luLWxlZnQ6IDJyZW07Cn0KCmRsIGR0IHsKICBwb3NpdGlvbjogcmVsYXRpdmU7CiAgbWFyZ2luOiAxLjVyZW0gMCAwOwp9CgpkbCBkZCB7CiAgcG9zaXRpb246IHJlbGF0aXZlOwogIG1hcmdpbjogMCAxcmVtIDA7Cn0KCmRkICsgZHQucHJlIHsKICBtYXJnaW4tdG9wOiAxLjZyZW07Cn0KCiNhcGljb250ZW50IHsKICBwYWRkaW5nLXRvcDogMXJlbTsKfQoKI2FwaWNvbnRlbnQgLmxpbmUgewogIHdpZHRoOiBjYWxjKDUwJSAtIDFyZW0pOwogIG1hcmdpbjogMXJlbSAxcmVtIC45NXJlbTsKICBiYWNrZ3JvdW5kLWNvbG9yOiAjY2NjOwp9CgpoMiArIGgyIHsKICBtYXJnaW46IDAgMCAuNXJlbTsKfQoKaDMgKyBoMyB7CiAgbWFyZ2luOiAwIDAgLjVyZW07Cn0KCmgyLCBoMywgaDQsIGg1IHsKICBwb3NpdGlvbjogcmVsYXRpdmU7CiAgcGFkZGluZy1yaWdodDogNDBweDsKfQoKLnNyY2xpbmsgewogIGZsb2F0OiByaWdodDsKICBmb250LXNpemU6IHNtYWxsZXI7Cn0KCmgxIHNwYW4sIGgyIHNwYW4sIGgzIHNwYW4sIGg0IHNwYW4gewogIHBvc2l0aW9uOiBhYnNvbHV0ZTsKICBkaXNwbGF5OiBibG9jazsKICB0b3A6IDA7CiAgcmlnaHQ6IDA7Cn0KCmgxIHNwYW46aG92ZXIsIGgyIHNwYW46aG92ZXIsIGgzIHNwYW46aG92ZXIsIGg0IHNwYW46aG92ZXIgewogIG9wYWNpdHk6IDE7Cn0KCmgxIHNwYW4gYSwgaDIgc3BhbiBhLCBoMyBzcGFuIGEsIGg0IHNwYW4gYSB7CiAgY29sb3I6ICMwMDA7CiAgdGV4dC1kZWNvcmF0aW9uOiBub25lOwogIGZvbnQtd2VpZ2h0OiBib2xkOwp9CgpwcmUsIHR0LCBjb2RlIHsKICBsaW5lLWhlaWdodDogMS41cmVtOwogIG1hcmdpbjogMDsgcGFkZGluZzogMDsKfQoKLnByZSB7CiAgbGluZS1oZWlnaHQ6IDEuNXJlbTsKfQoKcHJlIHsKICBwYWRkaW5nOiAxcmVtOwogIHZlcnRpY2FsLWFsaWduOiB0b3A7CiAgYmFja2dyb3VuZDogI2YyZjJmMjsKICBtYXJnaW46IDFyZW07CiAgb3ZlcmZsb3cteDogYXV0bzsKfQoKcHJlID4gY29kZSB7CiAgcGFkZGluZzogMDsKfQoKcHJlICsgaDMgewogIG1hcmdpbi10b3A6IDIuMjI1cmVtOwp9Cgpjb2RlLnByZSB7CiAgd2hpdGUtc3BhY2U6IHByZTsKfQoKI2ludHJvIHsKICBtYXJnaW4tdG9wOiAxLjI1cmVtOwogIG1hcmdpbi1sZWZ0OiAxcmVtOwp9CgojaW50cm8gYSB7CiAgY29sb3I6ICNkZGQ7CiAgZm9udC13ZWlnaHQ6IGJvbGQ7Cn0KCmhyIHsKICBiYWNrZ3JvdW5kOiBub25lOwogIGJvcmRlcjogbWVkaXVtIG5vbmU7CiAgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkICM3YTdhN2E7CiAgbWFyZ2luOiAwIDAgMXJlbSAwOwp9CgojdG9jIGgyIHsKICBtYXJnaW4tdG9wOiAwOwogIG1hcmdpbjogMS41cmVtIDA7Cn0KCiN0b2MgcCB7CiAgbWFyZ2luOiAwOwp9CgojdG9jIHVsIGEgewogIHRleHQtZGVjb3JhdGlvbjpub25lOwp9CgojdG9jIHVsIGxpIHsKICBtYXJnaW4tYm90dG9tOiAuNjY2cmVtOwogIGxpc3Qtc3R5bGU6IHNxdWFyZSBvdXRzaWRlOwp9CgojdG9jIGxpID4gdWwgewogIG1hcmdpbi10b3A6IC42NjZyZW07Cn0KCiN0b2MgLnN0YWJpbGl0eV8wOjphZnRlciB7CiAgYmFja2dyb3VuZC1jb2xvcjogI2Q1MDAyNzsKICBjb2xvcjogI2ZmZjsKICBjb250ZW50OiAiZGVwcmVjYXRlZCI7CiAgbWFyZ2luLWxlZnQ6IC4yNXJlbTsKICBwYWRkaW5nOiAxcHggM3B4OwogIGJvcmRlci1yYWRpdXM6IDNweDsKfQoKI2FwaWNvbnRlbnQgbGkgewogIG1hcmdpbi1ib3R0b206IC41cmVtOwp9CgojYXBpY29udGVudCBsaTpsYXN0LWNoaWxkIHsKICBtYXJnaW4tYm90dG9tOiAwOwp9Cgp0dCwgY29kZSB7CiAgY29sb3I6ICMwNDA0MDQ7CiAgYmFja2dyb3VuZC1jb2xvcjogI2YyZjJmMjsKICBib3JkZXItcmFkaXVzOiAycHg7CiAgcGFkZGluZzogMXB4IDNweDsKfQoKLmFwaV9zdGFiaWxpdHkgY29kZSB7CiAgYmFja2dyb3VuZDogcmdiYSgwLCAwLCAwLCAuMSk7Cn0KCmEgY29kZSB7CiAgY29sb3I6IGluaGVyaXQ7CiAgYmFja2dyb3VuZDogaW5oZXJpdDsKICBwYWRkaW5nOiAwOwp9CgoudHlwZSB7CiAgbGluZS1oZWlnaHQ6IDEuNXJlbTsKfQoKI2NvbHVtbjEuaW50ZXJpb3IgewogIG1hcmdpbi1sZWZ0OiAyMzRweDsKICBwYWRkaW5nOiAwIDJyZW07CiAgLXdlYmtpdC1wYWRkaW5nLXN0YXJ0OiAxLjVyZW07Cn0KCiNjb2x1bW4yLmludGVyaW9yIHsKICB3aWR0aDogMjM0cHg7CiAgYmFja2dyb3VuZDogIzMzMzsKICBwb3NpdGlvbjogZml4ZWQ7CiAgbGVmdDogMDsKICB0b3A6IDA7CiAgYm90dG9tOiAwOwogIG92ZXJmbG93LXg6IGhpZGRlbjsKICBvdmVyZmxvdy15OiBzY3JvbGw7Cn0KCiNjb2x1bW4yIHVsIHsKICBsaXN0LXN0eWxlOiBub25lOwogIG1hcmdpbjogLjlyZW0gMCAuNXJlbTsKICBiYWNrZ3JvdW5kOiAjMzMzOwp9CgojY29sdW1uMiA+IDpmaXJzdC1jaGlsZCB7CiAgbWFyZ2luOiAxLjI1cmVtOwogIGZvbnQtc2l6ZTogMS41cmVtOwp9CgojY29sdW1uMiA+IHVsOm50aC1jaGlsZCgyKSB7CiAgbWFyZ2luOiAxLjI1cmVtIDAgLjVyZW07Cn0KCiNjb2x1bW4yID4gdWw6bGFzdC1jaGlsZCB7CiAgbWFyZ2luOiAuOXJlbSAwIDEuMjVyZW07Cn0KCiNjb2x1bW4yIHVsIGxpIHsKICBwYWRkaW5nLWxlZnQ6IDEuMjVyZW07CiAgbWFyZ2luLWJvdHRvbTogLjVyZW07CiAgcGFkZGluZy1ib3R0b206IC41cmVtOwp9CgojY29sdW1uMiAubGluZSB7CiAgbWFyZ2luOiAwIC41cmVtOwogIGJhY2tncm91bmQtY29sb3I6ICM3MDcwNzA7Cn0KCiNjb2x1bW4yIHVsIGxpOmxhc3QtY2hpbGQgewogIG1hcmdpbi1ib3R0b206IDA7Cn0KCiNjb2x1bW4yIHVsIGxpIGEgewogIGNvbG9yOiAjY2NjOwogIGJvcmRlci1yYWRpdXM6IDA7Cn0KCiNjb2x1bW4yIHVsIGxpIGEuYWN0aXZlLCAjY29sdW1uMiB1bCBsaSBhLmFjdGl2ZTpob3ZlciwKI2NvbHVtbjIgdWwgbGkgYS5hY3RpdmU6Zm9jdXMgewogIGNvbG9yOiAjNDM4NTNkOwogIGJvcmRlci1yYWRpdXM6IDA7CiAgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkICM0Mzg1M2Q7CiAgYmFja2dyb3VuZDogbm9uZTsKfQoKI2ludHJvIGE6aG92ZXIsICNpbnRybyBhOmZvY3VzLAojY29sdW1uMiB1bCBsaSBhOmhvdmVyLCAjY29sdW1uMiB1bCBsaSBhOmZvY3VzIHsKICBjb2xvcjogI2ZmZjsKICBiYWNrZ3JvdW5kOiBub25lOwp9CgpzcGFuID4gLm1hcmssIHNwYW4gPiAubWFyazp2aXNpdGVkIHsKICBjb2xvcjogIzcwNzA3MDsKICBwb3NpdGlvbjogYWJzb2x1dGU7CiAgdG9wOiAwcHg7CiAgcmlnaHQ6IDBweDsKfQoKc3BhbiA+IC5tYXJrOmhvdmVyLCBzcGFuID4gLm1hcms6Zm9jdXMsIHNwYW4gPiAubWFyazphY3RpdmUgewogIGNvbG9yOiAjNDM4NTNkOwogIGJhY2tncm91bmQ6IG5vbmU7Cn0KCnRoID4gKjpsYXN0LWNoaWxkLCB0ZCA+ICo6bGFzdC1jaGlsZCB7CiAgbWFyZ2luLWJvdHRvbTogMDsKfQoKLmNoYW5nZWxvZyA+IHN1bW1hcnkgewogIG1hcmdpbjogLjVyZW0gMDsKICBwYWRkaW5nOiAuNXJlbSAwOwogIGN1cnNvcjogcG9pbnRlcjsKfQoKLyogc2ltcGxlciBjbGVhcmZpeCAqLwouY2xlYXJmaXg6YWZ0ZXIgewogIGNvbnRlbnQ6ICIuIjsKICBkaXNwbGF5OiBibG9jazsKICBoZWlnaHQ6IDA7CiAgY2xlYXI6IGJvdGg7CiAgdmlzaWJpbGl0eTogaGlkZGVuOwp9CgouZ2l0aHViX2ljb24gewogIHZlcnRpY2FsLWFsaWduOiBtaWRkbGU7CiAgbWFyZ2luOiAtMnB4IDNweCAwIDA7Cn0KCkBtZWRpYSBvbmx5IHNjcmVlbiBhbmQgKG1heC13aWR0aDogMTAyNHB4KSB7CiAgI2NvbnRlbnQgewogICAgb3ZlcmZsb3c6IHZpc2libGU7CiAgfQogICNjb2x1bW4xLmludGVyaW9yIHsKICAgIG1hcmdpbi1sZWZ0OiAwOwogICAgcGFkZGluZy1sZWZ0OiAuNXJlbTsKICAgIHBhZGRpbmctcmlnaHQ6IC41cmVtOwogICAgd2lkdGg6IGF1dG87CiAgICBvdmVyZmxvdy15OiB2aXNpYmxlOwogIH0KICAjY29sdW1uMiB7CiAgICBkaXNwbGF5OiBub25lOwogIH0KfQoKQG1lZGlhIHByaW50IHsKICBodG1sIHsKICAgIGhlaWdodDogYXV0bzsKICAgIGZvbnQtc2l6ZTogMC43NWVtOwogIH0KICAjY29sdW1uMi5pbnRlcmlvciB7CiAgICBkaXNwbGF5OiBub25lOwogIH0KICAjY29sdW1uMS5pbnRlcmlvciB7CiAgICBtYXJnaW4tbGVmdDogMHB4OwogICAgcGFkZGluZzogMHB4OwogICAgb3ZlcmZsb3cteTogYXV0bzsKICB9CiAgLmFwaV9tZXRhZGF0YSwKICAjdG9jLAogIC5zcmNsaW5rLAogICNndG9jLAogIC5tYXJrIHsKICAgIGRpc3BsYXk6IG5vbmU7CiAgfQogIGgxIHsKICAgIGZvbnQtc2l6ZTogMnJlbTsKICB9CiAgaDIgewogICAgZm9udC1zaXplOiAxLjc1cmVtOwogIH0KICBoMyB7CiAgICBmb250LXNpemU6IDEuNXJlbTsKICB9CiAgaDQgewogICAgZm9udC1zaXplOiAxLjNyZW07CiAgfQogIGg1IHsKICAgIGZvbnQtc2l6ZTogMS4ycmVtOwogIH0KICBoNiB7CiAgICBmb250LXNpemU6IDEuMXJlbTsKICB9CiAgLmFwaV9zdGFiaWxpdHkgewogICAgZGlzcGxheTogaW5saW5lLWJsb2NrOwogIH0KICAuYXBpX3N0YWJpbGl0eSBhIHsKICAgIHRleHQtZGVjb3JhdGlvbjogbm9uZTsKICB9CiAgYSB7CiAgICBjb2xvcjogaW5oZXJpdDsKICB9CiAgI2FwaWNvbnRlbnQgewogICAgb3ZlcmZsb3c6IGhpZGRlbjsKICB9Cn0K">

<link rel="stylesheet" href="data:text/css;base64,LnNoX3NvdXJjZUNvZGUgewogIGZvbnQtd2VpZ2h0OiBub3JtYWw7CiAgZm9udC1zdHlsZTogbm9ybWFsOwp9Cgouc2hfc291cmNlQ29kZSAuc2hfc3ltYm9sLAouc2hfc291cmNlQ29kZSAuc2hfY2JyYWNrZXQgewogIGNvbG9yOiAjMzMzOwp9Cgouc2hfc291cmNlQ29kZSAuc2hfa2V5d29yZCB7CiAgY29sb3I6ICMzMzg7Cn0KCi5zaF9zb3VyY2VDb2RlIC5zaF9zdHJpbmcsCi5zaF9zb3VyY2VDb2RlIC5zaF9yZWdleHAsCi5zaF9zb3VyY2VDb2RlIC5zaF9udW1iZXIsCi5zaF9zb3VyY2VDb2RlIC5zaF9zcGVjaWFsY2hhciB7CiAgY29sb3I6ICNFNTQzMDU7Cn0KCi5zaF9zb3VyY2VDb2RlIC5zaF9jb21tZW50IHsKICBjb2xvcjogIzY2NjsKICBmb250LXdlaWdodDogbGlnaHRlcjsKfQo=">

<link rel="canonical" href="https://nodejs.org/api/http2.html">

</head>

<body class="alt apidoc" id="api-section-http2">

<div id="content" class="clearfix">

<div id="column2" class="interior">

<div id="intro" class="interior">

<a href="https://nodejs.org/" title="Go back to the home page">

Node.js

</a>

</div>

<ul>

<li><a href="https://nodejs.org/api/documentation.html" class="nav-documentation">About these Docs</a></li>

<li><a href="https://nodejs.org/api/synopsis.html" class="nav-synopsis">Usage &amp; Example</a></li>

</ul>

<div class="line"></div>

<ul>

<li><a href="https://nodejs.org/api/assert.html" class="nav-assert">Assertion Testing</a></li>

<li><a href="https://nodejs.org/api/async_hooks.html" class="nav-async_hooks">Async Hooks</a></li>

<li><a href="https://nodejs.org/api/buffer.html" class="nav-buffer">Buffer</a></li>

<li><a href="https://nodejs.org/api/addons.html" class="nav-addons">C++ Addons</a></li>

<li><a href="https://nodejs.org/api/n-api.html" class="nav-n-api">C/C++ Addons - N-API</a></li>

<li><a href="https://nodejs.org/api/child_process.html" class="nav-child_process">Child Processes</a></li>

<li><a href="https://nodejs.org/api/cluster.html" class="nav-cluster">Cluster</a></li>

<li><a href="https://nodejs.org/api/cli.html" class="nav-cli">Command Line Options</a></li>

<li><a href="https://nodejs.org/api/console.html" class="nav-console">Console</a></li>

<li><a href="https://nodejs.org/api/crypto.html" class="nav-crypto">Crypto</a></li>

<li><a href="https://nodejs.org/api/debugger.html" class="nav-debugger">Debugger</a></li>

<li><a href="https://nodejs.org/api/deprecations.html" class="nav-deprecations">Deprecated APIs</a></li>

<li><a href="https://nodejs.org/api/dns.html" class="nav-dns">DNS</a></li>

<li><a href="https://nodejs.org/api/domain.html" class="nav-domain">Domain</a></li>

<li><a href="https://nodejs.org/api/esm.html" class="nav-esm">ECMAScript Modules</a></li>

<li><a href="https://nodejs.org/api/errors.html" class="nav-errors">Errors</a></li>

<li><a href="https://nodejs.org/api/events.html" class="nav-events">Events</a></li>

<li><a href="https://nodejs.org/api/fs.html" class="nav-fs">File System</a></li>

<li><a href="https://nodejs.org/api/globals.html" class="nav-globals">Globals</a></li>

<li><a href="https://nodejs.org/api/http.html" class="nav-http">HTTP</a></li>

<li><a href="https://nodejs.org/api/http2.html" class="nav-http2 active">HTTP/2</a></li>

<li><a href="https://nodejs.org/api/https.html" class="nav-https">HTTPS</a></li>

<li><a href="https://nodejs.org/api/inspector.html" class="nav-inspector">Inspector</a></li>

<li><a href="https://nodejs.org/api/intl.html" class="nav-intl">Internationalization</a></li>

<li><a href="https://nodejs.org/api/modules.html" class="nav-modules">Modules</a></li>

<li><a href="https://nodejs.org/api/net.html" class="nav-net">Net</a></li>

<li><a href="https://nodejs.org/api/os.html" class="nav-os">OS</a></li>

<li><a href="https://nodejs.org/api/path.html" class="nav-path">Path</a></li>

<li><a href="https://nodejs.org/api/perf_hooks.html" class="nav-perf_hooks">Performance Hooks</a></li>

<li><a href="https://nodejs.org/api/policy.html" class="nav-policy">Policies</a></li>

<li><a href="https://nodejs.org/api/process.html" class="nav-process">Process</a></li>

<li><a href="https://nodejs.org/api/punycode.html" class="nav-punycode">Punycode</a></li>

<li><a href="https://nodejs.org/api/querystring.html" class="nav-querystring">Query Strings</a></li>

<li><a href="https://nodejs.org/api/readline.html" class="nav-readline">Readline</a></li>

<li><a href="https://nodejs.org/api/repl.html" class="nav-repl">REPL</a></li>

<li><a href="https://nodejs.org/api/report.html" class="nav-report">Report</a></li>

<li><a href="https://nodejs.org/api/stream.html" class="nav-stream">Stream</a></li>

<li><a href="https://nodejs.org/api/string_decoder.html" class="nav-string_decoder">String Decoder</a></li>

<li><a href="https://nodejs.org/api/timers.html" class="nav-timers">Timers</a></li>

<li><a href="https://nodejs.org/api/tls.html" class="nav-tls">TLS/SSL</a></li>

<li><a href="https://nodejs.org/api/tracing.html" class="nav-tracing">Trace Events</a></li>

<li><a href="https://nodejs.org/api/tty.html" class="nav-tty">TTY</a></li>

<li><a href="https://nodejs.org/api/dgram.html" class="nav-dgram">UDP/Datagram</a></li>

<li><a href="https://nodejs.org/api/url.html" class="nav-url">URL</a></li>

<li><a href="https://nodejs.org/api/util.html" class="nav-util">Utilities</a></li>

<li><a href="https://nodejs.org/api/v8.html" class="nav-v8">V8</a></li>

<li><a href="https://nodejs.org/api/vm.html" class="nav-vm">VM</a></li>

<li><a href="https://nodejs.org/api/worker_threads.html" class="nav-worker_threads">Worker Threads</a></li>

<li><a href="https://nodejs.org/api/zlib.html" class="nav-zlib">Zlib</a></li>

</ul>

<div class="line"></div>

<ul>

<li><a href="https://github.com/nodejs/node" class="nav-https-github-com-nodejs-node">GitHub Repo &amp; Issue Tracker</a></li>

</ul>

</div>

<div id="column1" data-id="http2" class="interior">

<header>

<h1>Node.js v12.10.0 Documentation</h1>

<div id="gtoc">

<ul>

<li>

<a href="https://nodejs.org/api/index.html" name="toc">Index</a>

</li>

<li>

<a href="https://nodejs.org/api/all.html">View on single page</a>

</li>

<li>

<a href="https://nodejs.org/api/http2.json">View as JSON</a>

</li>

<li class="version-picker">

<a href="#">View another version <span>▼</span></a>

<ol class="version-picker"><li><a href="https://nodejs.org/docs/latest-v12.x/api/http2.html">12.x</a></li>

<li><a href="https://nodejs.org/docs/latest-v11.x/api/http2.html">11.x</a></li>

<li><a href="https://nodejs.org/docs/latest-v10.x/api/http2.html">10.x <b>LTS</b></a></li>

<li><a href="https://nodejs.org/docs/latest-v9.x/api/http2.html">9.x</a></li>

<li><a href="https://nodejs.org/docs/latest-v8.x/api/http2.html">8.x <b>LTS</b></a></li></ol>

</li>

<li class="edit_on_github"><a href="https://github.com/nodejs/node/edit/master/doc/api/http2.md"><span class="github_icon"><svg height="16" width="16" viewBox="0 0 16.1 16.1" fill="currentColor"><path d="M8 0a8 8 0 0 0-2.5 15.6c.4 0 .5-.2.5-.4v-1.5c-2 .4-2.5-.5-2.7-1 0-.1-.5-.9-.8-1-.3-.2-.7-.6 0-.6.6 0 1 .6 1.2.8.7 1.2 1.9 1 2.4.7 0-.5.2-.9.5-1-1.8-.3-3.7-1-3.7-4 0-.9.3-1.6.8-2.2 0-.2-.3-1 .1-2 0 0 .7-.3 2.2.7a7.4 7.4 0 0 1 4 0c1.5-1 2.2-.8 2.2-.8.5 1.1.2 2 .1 2.1.5.6.8 1.3.8 2.2 0 3-1.9 3.7-3.6 4 .3.2.5.7.5 1.4v2.2c0 .2.1.5.5.4A8 8 0 0 0 16 8a8 8 0 0 0-8-8z"></path></svg></span>Edit on GitHub</a></li>

</ul>

</div>

<hr>

</header>

<div id="toc">

<h2>Table of Contents</h2>

<ul>

<li>

<p><span class="stability_2"><a href="#http2_http_2">HTTP/2</a></span></p>

<ul>

<li>

<p><a href="#http2_core_api">Core API</a></p>

<ul>

<li><a href="#http2_server_side_example">Server-side example</a></li>

<li><a href="#http2_client_side_example">Client-side example</a></li>

<li>

<p><a href="#http2_class_http2session">Class: Http2Session</a></p>

<ul>

<li><a href="#http2_http2session_and_sockets">Http2Session and Sockets</a></li>

<li><a href="#http2_event_close">Event: 'close'</a></li>

<li><a href="#http2_event_connect">Event: 'connect'</a></li>

<li><a href="#http2_event_error">Event: 'error'</a></li>

<li><a href="#http2_event_frameerror">Event: 'frameError'</a></li>

<li><a href="#http2_event_goaway">Event: 'goaway'</a></li>

<li><a href="#http2_event_localsettings">Event: 'localSettings'</a></li>

<li><a href="#http2_event_ping">Event: 'ping'</a></li>

<li><a href="#http2_event_remotesettings">Event: 'remoteSettings'</a></li>

<li><a href="#http2_event_stream">Event: 'stream'</a></li>

<li><a href="#http2_event_timeout">Event: 'timeout'</a></li>

<li><a href="#http2_http2session_alpnprotocol">http2session.alpnProtocol</a></li>

<li><a href="#http2_http2session_close_callback">http2session.close([callback])</a></li>

<li><a href="#http2_http2session_closed">http2session.closed</a></li>

<li><a href="#http2_http2session_connecting">http2session.connecting</a></li>

<li><a href="#http2_http2session_destroy_error_code">http2session.destroy([error][, code])</a></li>

<li><a href="#http2_http2session_destroyed">http2session.destroyed</a></li>

<li><a href="#http2_http2session_encrypted">http2session.encrypted</a></li>

<li><a href="#http2_http2session_goaway_code_laststreamid_opaquedata">http2session.goaway([code[, lastStreamID[, opaqueData]]])</a></li>

<li><a href="#http2_http2session_localsettings">http2session.localSettings</a></li>

<li><a href="#http2_http2session_originset">http2session.originSet</a></li>

<li><a href="#http2_http2session_pendingsettingsack">http2session.pendingSettingsAck</a></li>

<li><a href="#http2_http2session_ping_payload_callback">http2session.ping([payload, ]callback)</a></li>

<li><a href="#http2_http2session_ref">http2session.ref()</a></li>

<li><a href="#http2_http2session_remotesettings">http2session.remoteSettings</a></li>

<li><a href="#http2_http2session_settimeout_msecs_callback">http2session.setTimeout(msecs, callback)</a></li>

<li><a href="#http2_http2session_socket">http2session.socket</a></li>

<li><a href="#http2_http2session_state">http2session.state</a></li>

<li><a href="#http2_http2session_settings_settings_callback">http2session.settings([settings][, callback])</a></li>

<li><a href="#http2_http2session_type">http2session.type</a></li>

<li><a href="#http2_http2session_unref">http2session.unref()</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_serverhttp2session">Class: ServerHttp2Session</a></p>

<ul>

<li><a href="#http2_serverhttp2session_altsvc_alt_originorstream">serverhttp2session.altsvc(alt, originOrStream)</a></li>

<li><a href="#http2_specifying_alternative_services">Specifying alternative services</a></li>

<li><a href="#http2_serverhttp2session_origin_origins">serverhttp2session.origin(...origins)</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_clienthttp2session">Class: ClientHttp2Session</a></p>

<ul>

<li><a href="#http2_event_altsvc">Event: 'altsvc'</a></li>

<li><a href="#http2_event_origin">Event: 'origin'</a></li>

<li><a href="#http2_clienthttp2session_request_headers_options">clienthttp2session.request(headers[, options])</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_http2stream">Class: Http2Stream</a></p>

<ul>

<li>

<p><a href="#http2_http2stream_lifecycle">Http2Stream Lifecycle</a></p>

<ul>

<li><a href="#http2_creation">Creation</a></li>

<li><a href="#http2_destruction">Destruction</a></li>

</ul>

</li>

<li><a href="#http2_event_aborted">Event: 'aborted'</a></li>

<li><a href="#http2_event_close_1">Event: 'close'</a></li>

<li><a href="#http2_event_error_1">Event: 'error'</a></li>

<li><a href="#http2_event_frameerror_1">Event: 'frameError'</a></li>

<li><a href="#http2_event_timeout_1">Event: 'timeout'</a></li>

<li><a href="#http2_event_trailers">Event: 'trailers'</a></li>

<li><a href="#http2_event_wanttrailers">Event: 'wantTrailers'</a></li>

<li><a href="#http2_http2stream_aborted">http2stream.aborted</a></li>

<li><a href="#http2_http2stream_buffersize">http2stream.bufferSize</a></li>

<li><a href="#http2_http2stream_close_code_callback">http2stream.close(code[, callback])</a></li>

<li><a href="#http2_http2stream_closed">http2stream.closed</a></li>

<li><a href="#http2_http2stream_destroyed">http2stream.destroyed</a></li>

<li><a href="#http2_http2stream_endafterheaders">http2stream.endAfterHeaders</a></li>

<li><a href="#http2_http2stream_id">http2stream.id</a></li>

<li><a href="#http2_http2stream_pending">http2stream.pending</a></li>

<li><a href="#http2_http2stream_priority_options">http2stream.priority(options)</a></li>

<li><a href="#http2_http2stream_rstcode">http2stream.rstCode</a></li>

<li><a href="#http2_http2stream_sentheaders">http2stream.sentHeaders</a></li>

<li><a href="#http2_http2stream_sentinfoheaders">http2stream.sentInfoHeaders</a></li>

<li><a href="#http2_http2stream_senttrailers">http2stream.sentTrailers</a></li>

<li><a href="#http2_http2stream_session">http2stream.session</a></li>

<li><a href="#http2_http2stream_settimeout_msecs_callback">http2stream.setTimeout(msecs, callback)</a></li>

<li><a href="#http2_http2stream_state">http2stream.state</a></li>

<li><a href="#http2_http2stream_sendtrailers_headers">http2stream.sendTrailers(headers)</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_clienthttp2stream">Class: ClientHttp2Stream</a></p>

<ul>

<li><a href="#http2_event_continue">Event: 'continue'</a></li>

<li><a href="#http2_event_headers">Event: 'headers'</a></li>

<li><a href="#http2_event_push">Event: 'push'</a></li>

<li><a href="#http2_event_response">Event: 'response'</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_serverhttp2stream">Class: ServerHttp2Stream</a></p>

<ul>

<li><a href="#http2_http2stream_additionalheaders_headers">http2stream.additionalHeaders(headers)</a></li>

<li><a href="#http2_http2stream_headerssent">http2stream.headersSent</a></li>

<li><a href="#http2_http2stream_pushallowed">http2stream.pushAllowed</a></li>

<li><a href="#http2_http2stream_pushstream_headers_options_callback">http2stream.pushStream(headers[, options], callback)</a></li>

<li><a href="#http2_http2stream_respond_headers_options">http2stream.respond([headers[, options]])</a></li>

<li><a href="#http2_http2stream_respondwithfd_fd_headers_options">http2stream.respondWithFD(fd[, headers[, options]])</a></li>

<li><a href="#http2_http2stream_respondwithfile_path_headers_options">http2stream.respondWithFile(path[, headers[, options]])</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_http2server">Class: Http2Server</a></p>

<ul>

<li><a href="#http2_event_checkcontinue">Event: 'checkContinue'</a></li>

<li><a href="#http2_event_request">Event: 'request'</a></li>

<li><a href="#http2_event_session">Event: 'session'</a></li>

<li><a href="#http2_event_sessionerror">Event: 'sessionError'</a></li>

<li><a href="#http2_event_stream_1">Event: 'stream'</a></li>

<li><a href="#http2_event_timeout_2">Event: 'timeout'</a></li>

<li><a href="#http2_server_close_callback">server.close([callback])</a></li>

<li><a href="#http2_server_settimeout_msecs_callback">server.setTimeout([msecs][, callback])</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_http2secureserver">Class: Http2SecureServer</a></p>

<ul>

<li><a href="#http2_event_checkcontinue_1">Event: 'checkContinue'</a></li>

<li><a href="#http2_event_request_1">Event: 'request'</a></li>

<li><a href="#http2_event_session_1">Event: 'session'</a></li>

<li><a href="#http2_event_sessionerror_1">Event: 'sessionError'</a></li>

<li><a href="#http2_event_stream_2">Event: 'stream'</a></li>

<li><a href="#http2_event_timeout_3">Event: 'timeout'</a></li>

<li><a href="#http2_event_unknownprotocol">Event: 'unknownProtocol'</a></li>

<li><a href="#http2_server_close_callback_1">server.close([callback])</a></li>

<li><a href="#http2_server_settimeout_msecs_callback_1">server.setTimeout([msecs][, callback])</a></li>

</ul>

</li>

<li><a href="#http2_http2_createserver_options_onrequesthandler">http2.createServer(options[, onRequestHandler])</a></li>

<li><a href="#http2_http2_createsecureserver_options_onrequesthandler">http2.createSecureServer(options[, onRequestHandler])</a></li>

<li><a href="#http2_http2_connect_authority_options_listener">http2.connect(authority[, options][, listener])</a></li>

<li>

<p><a href="#http2_http2_constants">http2.constants</a></p>

<ul>

<li><a href="#http2_error_codes_for_rst_stream_and_goaway">Error Codes for RST_STREAM and GOAWAY</a></li>

</ul>

</li>

<li><a href="#http2_http2_getdefaultsettings">http2.getDefaultSettings()</a></li>

<li><a href="#http2_http2_getpackedsettings_settings">http2.getPackedSettings([settings])</a></li>

<li><a href="#http2_http2_getunpackedsettings_buf">http2.getUnpackedSettings(buf)</a></li>

<li><a href="#http2_headers_object">Headers Object</a></li>

<li><a href="#http2_settings_object">Settings Object</a></li>

<li><a href="#http2_using_options_selectpadding">Using <code>options.selectPadding()</code></a></li>

<li><a href="#http2_error_handling">Error Handling</a></li>

<li><a href="#http2_invalid_character_handling_in_header_names_and_values">Invalid character handling in header names and values</a></li>

<li><a href="#http2_push_streams_on_the_client">Push streams on the client</a></li>

<li><a href="#http2_supporting_the_connect_method">Supporting the CONNECT method</a></li>

<li><a href="#http2_the_extended_connect_protocol">The Extended CONNECT Protocol</a></li>

</ul>

</li>

<li>

<p><a href="#http2_compatibility_api">Compatibility API</a></p>

<ul>

<li><a href="#http2_alpn_negotiation">ALPN negotiation</a></li>

<li>

<p><a href="#http2_class_http2_http2serverrequest">Class: http2.Http2ServerRequest</a></p>

<ul>

<li><a href="#http2_event_aborted_1">Event: 'aborted'</a></li>

<li><a href="#http2_event_close_2">Event: 'close'</a></li>

<li><a href="#http2_request_aborted">request.aborted</a></li>

<li><a href="#http2_request_authority">request.authority</a></li>

<li><a href="#http2_request_destroy_error">request.destroy([error])</a></li>

<li><a href="#http2_request_headers">request.headers</a></li>

<li><a href="#http2_request_httpversion">request.httpVersion</a></li>

<li><a href="#http2_request_method">request.method</a></li>

<li><a href="#http2_request_rawheaders">request.rawHeaders</a></li>

<li><a href="#http2_request_rawtrailers">request.rawTrailers</a></li>

<li><a href="#http2_request_scheme">request.scheme</a></li>

<li><a href="#http2_request_settimeout_msecs_callback">request.setTimeout(msecs, callback)</a></li>

<li><a href="#http2_request_socket">request.socket</a></li>

<li><a href="#http2_request_stream">request.stream</a></li>

<li><a href="#http2_request_trailers">request.trailers</a></li>

<li><a href="#http2_request_url">request.url</a></li>

</ul>

</li>

<li>

<p><a href="#http2_class_http2_http2serverresponse">Class: http2.Http2ServerResponse</a></p>

<ul>

<li><a href="#http2_event_close_3">Event: 'close'</a></li>

<li><a href="#http2_event_finish">Event: 'finish'</a></li>

<li><a href="#http2_response_addtrailers_headers">response.addTrailers(headers)</a></li>

<li><a href="#http2_response_connection">response.connection</a></li>

<li><a href="#http2_response_end_data_encoding_callback">response.end([data][, encoding][, callback])</a></li>

<li><a href="#http2_response_finished">response.finished</a></li>

<li><a href="#http2_response_getheader_name">response.getHeader(name)</a></li>

<li><a href="#http2_response_getheadernames">response.getHeaderNames()</a></li>

<li><a href="#http2_response_getheaders">response.getHeaders()</a></li>

<li><a href="#http2_response_hasheader_name">response.hasHeader(name)</a></li>

<li><a href="#http2_response_headerssent">response.headersSent</a></li>

<li><a href="#http2_response_removeheader_name">response.removeHeader(name)</a></li>

<li><a href="#http2_response_senddate">response.sendDate</a></li>

<li><a href="#http2_response_setheader_name_value">response.setHeader(name, value)</a></li>

<li><a href="#http2_response_settimeout_msecs_callback">response.setTimeout(msecs[, callback])</a></li>

<li><a href="#http2_response_socket">response.socket</a></li>

<li><a href="#http2_response_statuscode">response.statusCode</a></li>

<li><a href="#http2_response_statusmessage">response.statusMessage</a></li>

<li><a href="#http2_response_stream">response.stream</a></li>

<li><a href="#http2_response_writableended">response.writableEnded</a></li>

<li><a href="#http2_response_write_chunk_encoding_callback">response.write(chunk[, encoding][, callback])</a></li>

<li><a href="#http2_response_writecontinue">response.writeContinue()</a></li>

<li><a href="#http2_response_writehead_statuscode_statusmessage_headers">response.writeHead(statusCode[, statusMessage][, headers])</a></li>

<li><a href="#http2_response_createpushresponse_headers_callback">response.createPushResponse(headers, callback)</a></li>

</ul>

</li>

</ul>

</li>

<li><a href="#http2_collecting_http_2_performance_metrics">Collecting HTTP/2 Performance Metrics</a></li>

</ul>

</li>

</ul>

</div>

<div id="apicontent">

<h1>HTTP/2<span><a class="mark" href="#http2_http_2" id="http2_http_2">#</a></span></h1>

<div class="api_metadata">

<details class="changelog"><summary>History</summary>

<table>

<tbody><tr><th>Version</th><th>Changes</th></tr>

<tr><td>v10.10.0</td>

<td><p>HTTP/2 is now Stable. Previously, it had been Experimental.</p></td></tr>

<tr><td>v8.4.0</td>

<td><p><span>Added in: v8.4.0</span></p></td></tr>

</tbody></table>

</details>

</div>

<p></p><div class="api_stability api_stability_2"><a href="https://nodejs.org/api/documentation.html#documentation_stability_index">Stability: 2</a> - Stable</div><p></p>

<p>The <code>http2</code> module provides an implementation of the <a href="https://tools.ietf.org/html/rfc7540">HTTP/2</a> protocol. It

can be accessed using:</p>

<pre><code class="language-js">const http2 = require('http2');

</code></pre>

<h2>Core API<span><a class="mark" href="#http2_core_api" id="http2_core_api">#</a></span></h2>

<p>The Core API provides a low-level interface designed specifically around

support for HTTP/2 protocol features. It is specifically <em>not</em> designed for

compatibility with the existing <a href="https://nodejs.org/api/http.html">HTTP/1</a> module API. However,

the <a href="#http2_compatibility_api">Compatibility API</a> is.</p>

<p>The <code>http2</code> Core API is much more symmetric between client and server than the

<code>http</code> API. For instance, most events, like <code>'error'</code>, <code>'connect'</code> and

<code>'stream'</code>, can be emitted either by client-side code or server-side code.</p>

<h3>Server-side example<span><a class="mark" href="#http2_server_side_example" id="http2_server_side_example">#</a></span></h3>

<p>The following illustrates a simple HTTP/2 server using the Core API.

Since there are no browsers known that support

<a href="https://http2.github.io/faq/#does-http2-require-encryption">unencrypted HTTP/2</a>, the use of

<a href="#http2_http2_createsecureserver_options_onrequesthandler"><code>http2.createSecureServer()</code></a> is necessary when communicating

with browser clients.</p>

<pre><code class="language-js">const http2 = require('http2');

const fs = require('fs');

const server = http2.createSecureServer({

key: fs.readFileSync('localhost-privkey.pem'),

cert: fs.readFileSync('localhost-cert.pem')

});

server.on('error', (err) =&gt; console.error(err));

server.on('stream', (stream, headers) =&gt; {

// stream is a Duplex

stream.respond({

'content-type': 'text/html',

':status': 200

});

stream.end('&lt;h1&gt;Hello World&lt;/h1&gt;');

});

server.listen(8443);

</code></pre>

<p>To generate the certificate and key for this example, run:</p>

<pre><code class="language-bash">openssl req -x509 -newkey rsa:2048 -nodes -sha256 -subj '/CN=localhost' \

-keyout localhost-privkey.pem -out localhost-cert.pem

</code></pre>

<h3>Client-side example<span><a class="mark" href="#http2_client_side_example" id="http2_client_side_example">#</a></span></h3>

<p>The following illustrates an HTTP/2 client:</p>

<pre><code class="language-js">const http2 = require('http2');

const fs = require('fs');

const client = http2.connect('https://localhost:8443', {

ca: fs.readFileSync('localhost-cert.pem')

});

client.on('error', (err) =&gt; console.error(err));

const req = client.request({ ':path': '/' });

req.on('response', (headers, flags) =&gt; {

for (const name in headers) {

console.log(`${name}: ${headers[name]}`);

}

});

req.setEncoding('utf8');

let data = '';

req.on('data', (chunk) =&gt; { data += chunk; });

req.on('end', () =&gt; {

console.log(`\n${data}`);

client.close();

});

req.end();

</code></pre>

<h3>Class: Http2Session<span><a class="mark" href="#http2_class_http2session" id="http2_class_http2session">#</a></span></h3>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li>Extends: <a href="https://nodejs.org/api/events.html#events_class_eventemitter" class="type">&lt;EventEmitter&gt;</a></li>

</ul>

<p>Instances of the <code>http2.Http2Session</code> class represent an active communications

session between an HTTP/2 client and server. Instances of this class are <em>not</em>

intended to be constructed directly by user code.</p>

<p>Each <code>Http2Session</code> instance will exhibit slightly different behaviors

depending on whether it is operating as a server or a client. The

<code>http2session.type</code> property can be used to determine the mode in which an

<code>Http2Session</code> is operating. On the server side, user code should rarely

have occasion to work with the <code>Http2Session</code> object directly, with most

actions typically taken through interactions with either the <code>Http2Server</code> or

<code>Http2Stream</code> objects.</p>

<p>User code will not create <code>Http2Session</code> instances directly. Server-side

<code>Http2Session</code> instances are created by the <code>Http2Server</code> instance when a

new HTTP/2 connection is received. Client-side <code>Http2Session</code> instances are

created using the <code>http2.connect()</code> method.</p>

<h4>Http2Session and Sockets<span><a class="mark" href="#http2_http2session_and_sockets" id="http2_http2session_and_sockets">#</a></span></h4>

<p>Every <code>Http2Session</code> instance is associated with exactly one <a href="https://nodejs.org/api/net.html#net_class_net_socket"><code>net.Socket</code></a> or

<a href="https://nodejs.org/api/tls.html#tls_class_tls_tlssocket"><code>tls.TLSSocket</code></a> when it is created. When either the <code>Socket</code> or the

<code>Http2Session</code> are destroyed, both will be destroyed.</p>

<p>Because of the specific serialization and processing requirements imposed

by the HTTP/2 protocol, it is not recommended for user code to read data from

or write data to a <code>Socket</code> instance bound to a <code>Http2Session</code>. Doing so can

put the HTTP/2 session into an indeterminate state causing the session and

the socket to become unusable.</p>

<p>Once a <code>Socket</code> has been bound to an <code>Http2Session</code>, user code should rely

solely on the API of the <code>Http2Session</code>.</p>

<h4>Event: 'close'<span><a class="mark" href="#http2_event_close" id="http2_event_close">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<p>The <code>'close'</code> event is emitted once the <code>Http2Session</code> has been destroyed. Its

listener does not expect any arguments.</p>

<h4>Event: 'connect'<span><a class="mark" href="#http2_event_connect" id="http2_event_connect">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>session</code> <a href="https://nodejs.org/api/http2.html#http2_class_http2session" class="type">&lt;Http2Session&gt;</a></li>

<li><code>socket</code> <a href="https://nodejs.org/api/net.html#net_class_net_socket" class="type">&lt;net.Socket&gt;</a></li>

</ul>

<p>The <code>'connect'</code> event is emitted once the <code>Http2Session</code> has been successfully

connected to the remote peer and communication may begin.</p>

<p>User code will typically not listen for this event directly.</p>

<h4>Event: 'error'<span><a class="mark" href="#http2_event_error" id="http2_event_error">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>error</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error" class="type">&lt;Error&gt;</a></li>

</ul>

<p>The <code>'error'</code> event is emitted when an error occurs during the processing of

an <code>Http2Session</code>.</p>

<h4>Event: 'frameError'<span><a class="mark" href="#http2_event_frameerror" id="http2_event_frameerror">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>type</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;integer&gt;</a> The frame type.</li>

<li><code>code</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;integer&gt;</a> The error code.</li>

<li><code>id</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;integer&gt;</a> The stream id (or <code>0</code> if the frame isn't associated with a

stream).</li>

</ul>

<p>The <code>'frameError'</code> event is emitted when an error occurs while attempting to

send a frame on the session. If the frame that could not be sent is associated

with a specific <code>Http2Stream</code>, an attempt to emit a <code>'frameError'</code> event on the

<code>Http2Stream</code> is made.</p>

<p>If the <code>'frameError'</code> event is associated with a stream, the stream will be

closed and destroyed immediately following the <code>'frameError'</code> event. If the

event is not associated with a stream, the <code>Http2Session</code> will be shut down

immediately following the <code>'frameError'</code> event.</p>

<h4>Event: 'goaway'<span><a class="mark" href="#http2_event_goaway" id="http2_event_goaway">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>errorCode</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The HTTP/2 error code specified in the <code>GOAWAY</code> frame.</li>

<li><code>lastStreamID</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The ID of the last stream the remote peer successfully

processed (or <code>0</code> if no ID is specified).</li>

<li><code>opaqueData</code> <a href="https://nodejs.org/api/buffer.html#buffer_class_buffer" class="type">&lt;Buffer&gt;</a> If additional opaque data was included in the <code>GOAWAY</code>

frame, a <code>Buffer</code> instance will be passed containing that data.</li>

</ul>

<p>The <code>'goaway'</code> event is emitted when a <code>GOAWAY</code> frame is received.</p>

<p>The <code>Http2Session</code> instance will be shut down automatically when the <code>'goaway'</code>

event is emitted.</p>

<h4>Event: 'localSettings'<span><a class="mark" href="#http2_event_localsettings" id="http2_event_localsettings">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>settings</code> <a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a> A copy of the <code>SETTINGS</code> frame received.</li>

</ul>

<p>The <code>'localSettings'</code> event is emitted when an acknowledgment <code>SETTINGS</code> frame

has been received.</p>

<p>When using <code>http2session.settings()</code> to submit new settings, the modified

settings do not take effect until the <code>'localSettings'</code> event is emitted.</p>

<pre><code class="language-js">session.settings({ enablePush: false });

session.on('localSettings', (settings) =&gt; {

/* Use the new settings */

});

</code></pre>

<h4>Event: 'ping'<span><a class="mark" href="#http2_event_ping" id="http2_event_ping">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v10.12.0</span>

</div>

<ul>

<li><code>payload</code> <a href="https://nodejs.org/api/buffer.html#buffer_class_buffer" class="type">&lt;Buffer&gt;</a> The <code>PING</code> frame 8-byte payload</li>

</ul>

<p>The <code>'ping'</code> event is emitted whenever a <code>PING</code> frame is received from the

connected peer.</p>

<h4>Event: 'remoteSettings'<span><a class="mark" href="#http2_event_remotesettings" id="http2_event_remotesettings">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>settings</code> <a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a> A copy of the <code>SETTINGS</code> frame received.</li>

</ul>

<p>The <code>'remoteSettings'</code> event is emitted when a new <code>SETTINGS</code> frame is received

from the connected peer.</p>

<pre><code class="language-js">session.on('remoteSettings', (settings) =&gt; {

/* Use the new settings */

});

</code></pre>

<h4>Event: 'stream'<span><a class="mark" href="#http2_event_stream" id="http2_event_stream">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>stream</code> <a href="https://nodejs.org/api/http2.html#http2_class_http2stream" class="type">&lt;Http2Stream&gt;</a> A reference to the stream</li>

<li><code>headers</code> <a href="https://nodejs.org/api/http2.html#http2_headers_object" class="type">&lt;HTTP/2 Headers Object&gt;</a> An object describing the headers</li>

<li><code>flags</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The associated numeric flags</li>

<li><code>rawHeaders</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type">&lt;Array&gt;</a> An array containing the raw header names followed by

their respective values.</li>

</ul>

<p>The <code>'stream'</code> event is emitted when a new <code>Http2Stream</code> is created.</p>

<pre><code class="language-js">const http2 = require('http2');

session.on('stream', (stream, headers, flags) =&gt; {

const method = headers[':method'];

const path = headers[':path'];

// ...

stream.respond({

':status': 200,

'content-type': 'text/plain'

});

stream.write('hello ');

stream.end('world');

});

</code></pre>

<p>On the server side, user code will typically not listen for this event directly,

and would instead register a handler for the <code>'stream'</code> event emitted by the

<code>net.Server</code> or <code>tls.Server</code> instances returned by <code>http2.createServer()</code> and

<code>http2.createSecureServer()</code>, respectively, as in the example below:</p>

<pre><code class="language-js">const http2 = require('http2');

// Create an unencrypted HTTP/2 server

const server = http2.createServer();

server.on('stream', (stream, headers) =&gt; {

stream.respond({

'content-type': 'text/html',

':status': 200

});

stream.on('error', (error) =&gt; console.error(error));

stream.end('&lt;h1&gt;Hello World&lt;/h1&gt;');

});

server.listen(80);

</code></pre>

<p>Even though HTTP/2 streams and network sockets are not in a 1:1 correspondence,

a network error will destroy each individual stream and must be handled on the

stream level, as shown above.</p>

<h4>Event: 'timeout'<span><a class="mark" href="#http2_event_timeout" id="http2_event_timeout">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<p>After the <code>http2session.setTimeout()</code> method is used to set the timeout period

for this <code>Http2Session</code>, the <code>'timeout'</code> event is emitted if there is no

activity on the <code>Http2Session</code> after the configured number of milliseconds.</p>

<pre><code class="language-js">session.setTimeout(2000);

session.on('timeout', () =&gt; { /* .. */ });

</code></pre>

<h4>http2session.alpnProtocol<span><a class="mark" href="#http2_http2session_alpnprotocol" id="http2_http2session_alpnprotocol">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Undefined_type" class="type">&lt;undefined&gt;</a></li>

</ul>

<p>Value will be <code>undefined</code> if the <code>Http2Session</code> is not yet connected to a

socket, <code>h2c</code> if the <code>Http2Session</code> is not connected to a <code>TLSSocket</code>, or

will return the value of the connected <code>TLSSocket</code>'s own <code>alpnProtocol</code>

property.</p>

<h4>http2session.close([callback])<span><a class="mark" href="#http2_http2session_close_callback" id="http2_http2session_close_callback">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><code>callback</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="type">&lt;Function&gt;</a></li>

</ul>

<p>Gracefully closes the <code>Http2Session</code>, allowing any existing streams to

complete on their own and preventing new <code>Http2Stream</code> instances from being

created. Once closed, <code>http2session.destroy()</code> <em>might</em> be called if there

are no open <code>Http2Stream</code> instances.</p>

<p>If specified, the <code>callback</code> function is registered as a handler for the

<code>'close'</code> event.</p>

<h4>http2session.closed<span><a class="mark" href="#http2_http2session_closed" id="http2_http2session_closed">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a></li>

</ul>

<p>Will be <code>true</code> if this <code>Http2Session</code> instance has been closed, otherwise

<code>false</code>.</p>

<h4>http2session.connecting<span><a class="mark" href="#http2_http2session_connecting" id="http2_http2session_connecting">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v10.0.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a></li>

</ul>

<p>Will be <code>true</code> if this <code>Http2Session</code> instance is still connecting, will be set

to <code>false</code> before emitting <code>connect</code> event and/or calling the <code>http2.connect</code>

callback.</p>

<h4>http2session.destroy([error][, code])<span><a class="mark" href="#http2_http2session_destroy_error_code" id="http2_http2session_destroy_error_code">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>error</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error" class="type">&lt;Error&gt;</a> An <code>Error</code> object if the <code>Http2Session</code> is being destroyed

due to an error.</li>

<li><code>code</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The HTTP/2 error code to send in the final <code>GOAWAY</code> frame.

If unspecified, and <code>error</code> is not undefined, the default is <code>INTERNAL_ERROR</code>,

otherwise defaults to <code>NO_ERROR</code>.</li>

</ul>

<p>Immediately terminates the <code>Http2Session</code> and the associated <code>net.Socket</code> or

<code>tls.TLSSocket</code>.</p>

<p>Once destroyed, the <code>Http2Session</code> will emit the <code>'close'</code> event. If <code>error</code>

is not undefined, an <code>'error'</code> event will be emitted immediately before the

<code>'close'</code> event.</p>

<p>If there are any remaining open <code>Http2Streams</code> associated with the

<code>Http2Session</code>, those will also be destroyed.</p>

<h4>http2session.destroyed<span><a class="mark" href="#http2_http2session_destroyed" id="http2_http2session_destroyed">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a></li>

</ul>

<p>Will be <code>true</code> if this <code>Http2Session</code> instance has been destroyed and must no

longer be used, otherwise <code>false</code>.</p>

<h4>http2session.encrypted<span><a class="mark" href="#http2_http2session_encrypted" id="http2_http2session_encrypted">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Undefined_type" class="type">&lt;undefined&gt;</a></li>

</ul>

<p>Value is <code>undefined</code> if the <code>Http2Session</code> session socket has not yet been

connected, <code>true</code> if the <code>Http2Session</code> is connected with a <code>TLSSocket</code>,

and <code>false</code> if the <code>Http2Session</code> is connected to any other kind of socket

or stream.</p>

<h4>http2session.goaway([code[, lastStreamID[, opaqueData]]])<span><a class="mark" href="#http2_http2session_goaway_code_laststreamid_opaquedata" id="http2_http2session_goaway_code_laststreamid_opaquedata">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><code>code</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> An HTTP/2 error code</li>

<li><code>lastStreamID</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The numeric ID of the last processed <code>Http2Stream</code></li>

<li><code>opaqueData</code> <a href="https://nodejs.org/api/buffer.html#buffer_class_buffer" class="type">&lt;Buffer&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray" class="type">&lt;TypedArray&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView" class="type">&lt;DataView&gt;</a> A <code>TypedArray</code> or <code>DataView</code>

instance containing additional data to be carried within the <code>GOAWAY</code> frame.</li>

</ul>

<p>Transmits a <code>GOAWAY</code> frame to the connected peer <em>without</em> shutting down the

<code>Http2Session</code>.</p>

<h4>http2session.localSettings<span><a class="mark" href="#http2_http2session_localsettings" id="http2_http2session_localsettings">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a></li>

</ul>

<p>A prototype-less object describing the current local settings of this

<code>Http2Session</code>. The local settings are local to <em>this</em> <code>Http2Session</code> instance.</p>

<h4>http2session.originSet<span><a class="mark" href="#http2_http2session_originset" id="http2_http2session_originset">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string[]&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Undefined_type" class="type">&lt;undefined&gt;</a></li>

</ul>

<p>If the <code>Http2Session</code> is connected to a <code>TLSSocket</code>, the <code>originSet</code> property

will return an <code>Array</code> of origins for which the <code>Http2Session</code> may be

considered authoritative.</p>

<p>The <code>originSet</code> property is only available when using a secure TLS connection.</p>

<h4>http2session.pendingSettingsAck<span><a class="mark" href="#http2_http2session_pendingsettingsack" id="http2_http2session_pendingsettingsack">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a></li>

</ul>

<p>Indicates whether the <code>Http2Session</code> is currently waiting for acknowledgment of

a sent <code>SETTINGS</code> frame. Will be <code>true</code> after calling the

<code>http2session.settings()</code> method. Will be <code>false</code> once all sent <code>SETTINGS</code>

frames have been acknowledged.</p>

<h4>http2session.ping([payload, ]callback)<span><a class="mark" href="#http2_http2session_ping_payload_callback" id="http2_http2session_ping_payload_callback">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.9.3</span>

</div>

<ul>

<li><code>payload</code> <a href="https://nodejs.org/api/buffer.html#buffer_class_buffer" class="type">&lt;Buffer&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray" class="type">&lt;TypedArray&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView" class="type">&lt;DataView&gt;</a> Optional ping payload.</li>

<li><code>callback</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="type">&lt;Function&gt;</a></li>

<li>Returns: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type">&lt;boolean&gt;</a></li>

</ul>

<p>Sends a <code>PING</code> frame to the connected HTTP/2 peer. A <code>callback</code> function must

be provided. The method will return <code>true</code> if the <code>PING</code> was sent, <code>false</code>

otherwise.</p>

<p>The maximum number of outstanding (unacknowledged) pings is determined by the

<code>maxOutstandingPings</code> configuration option. The default maximum is 10.</p>

<p>If provided, the <code>payload</code> must be a <code>Buffer</code>, <code>TypedArray</code>, or <code>DataView</code>

containing 8 bytes of data that will be transmitted with the <code>PING</code> and

returned with the ping acknowledgment.</p>

<p>The callback will be invoked with three arguments: an error argument that will

be <code>null</code> if the <code>PING</code> was successfully acknowledged, a <code>duration</code> argument

that reports the number of milliseconds elapsed since the ping was sent and the

acknowledgment was received, and a <code>Buffer</code> containing the 8-byte <code>PING</code>

payload.</p>

<pre><code class="language-js">session.ping(Buffer.from('abcdefgh'), (err, duration, payload) =&gt; {

if (!err) {

console.log(`Ping acknowledged in ${duration} milliseconds`);

console.log(`With payload '${payload.toString()}'`);

}

});

</code></pre>

<p>If the <code>payload</code> argument is not specified, the default payload will be the

64-bit timestamp (little endian) marking the start of the <code>PING</code> duration.</p>

<h4>http2session.ref()<span><a class="mark" href="#http2_http2session_ref" id="http2_http2session_ref">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<p>Calls <a href="https://nodejs.org/api/net.html#net_socket_ref"><code>ref()</code></a> on this <code>Http2Session</code>

instance's underlying <a href="https://nodejs.org/api/net.html#net_class_net_socket"><code>net.Socket</code></a>.</p>

<h4>http2session.remoteSettings<span><a class="mark" href="#http2_http2session_remotesettings" id="http2_http2session_remotesettings">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a></li>

</ul>

<p>A prototype-less object describing the current remote settings of this

<code>Http2Session</code>. The remote settings are set by the <em>connected</em> HTTP/2 peer.</p>

<h4>http2session.setTimeout(msecs, callback)<span><a class="mark" href="#http2_http2session_settimeout_msecs_callback" id="http2_http2session_settimeout_msecs_callback">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>msecs</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>

<li><code>callback</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="type">&lt;Function&gt;</a></li>

</ul>

<p>Used to set a callback function that is called when there is no activity on

the <code>Http2Session</code> after <code>msecs</code> milliseconds. The given <code>callback</code> is

registered as a listener on the <code>'timeout'</code> event.</p>

<h4>http2session.socket<span><a class="mark" href="#http2_http2session_socket" id="http2_http2session_socket">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://nodejs.org/api/net.html#net_class_net_socket" class="type">&lt;net.Socket&gt;</a> | <a href="https://nodejs.org/api/tls.html#tls_class_tls_tlssocket" class="type">&lt;tls.TLSSocket&gt;</a></li>

</ul>

<p>Returns a <code>Proxy</code> object that acts as a <code>net.Socket</code> (or <code>tls.TLSSocket</code>) but

limits available methods to ones safe to use with HTTP/2.</p>

<p><code>destroy</code>, <code>emit</code>, <code>end</code>, <code>pause</code>, <code>read</code>, <code>resume</code>, and <code>write</code> will throw

an error with code <code>ERR_HTTP2_NO_SOCKET_MANIPULATION</code>. See

<a href="#http2_http2session_and_sockets"><code>Http2Session</code> and Sockets</a> for more information.</p>

<p><code>setTimeout</code> method will be called on this <code>Http2Session</code>.</p>

<p>All other interactions will be routed directly to the socket.</p>

<h4>http2session.state<span><a class="mark" href="#http2_http2session_state" id="http2_http2session_state">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<p>Provides miscellaneous information about the current state of the

<code>Http2Session</code>.</p>

<ul>

<li>

<p><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type">&lt;Object&gt;</a></p>

<ul>

<li><code>effectiveLocalWindowSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The current local (receive)

flow control window size for the <code>Http2Session</code>.</li>

<li><code>effectiveRecvDataLength</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The current number of bytes

that have been received since the last flow control <code>WINDOW_UPDATE</code>.</li>

<li><code>nextStreamID</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The numeric identifier to be used the

next time a new <code>Http2Stream</code> is created by this <code>Http2Session</code>.</li>

<li><code>localWindowSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The number of bytes that the remote peer can

send without receiving a <code>WINDOW_UPDATE</code>.</li>

<li><code>lastProcStreamID</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The numeric id of the <code>Http2Stream</code>

for which a <code>HEADERS</code> or <code>DATA</code> frame was most recently received.</li>

<li><code>remoteWindowSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The number of bytes that this <code>Http2Session</code>

may send without receiving a <code>WINDOW_UPDATE</code>.</li>

<li><code>outboundQueueSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The number of frames currently within the

outbound queue for this <code>Http2Session</code>.</li>

<li><code>deflateDynamicTableSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The current size in bytes of the

outbound header compression state table.</li>

<li><code>inflateDynamicTableSize</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> The current size in bytes of the

inbound header compression state table.</li>

</ul>

</li>

</ul>

<p>An object describing the current status of this <code>Http2Session</code>.</p>

<h4>http2session.settings([settings][, callback])<span><a class="mark" href="#http2_http2session_settings_settings_callback" id="http2_http2session_settings_settings_callback">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><code>settings</code> <a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a></li>

<li>

<p><code>callback</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" class="type">&lt;Function&gt;</a> Callback that is called once the session is connected or

right away if the session is already connected.</p>

<ul>

<li><code>err</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error" class="type">&lt;Error&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Null_type" class="type">&lt;null&gt;</a></li>

<li><code>settings</code> <a href="https://nodejs.org/api/http2.html#http2_settings_object" class="type">&lt;HTTP/2 Settings Object&gt;</a> The updated <code>settings</code> object.</li>

<li><code>duration</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;integer&gt;</a></li>

</ul>

</li>

</ul>

<p>Updates the current local settings for this <code>Http2Session</code> and sends a new

<code>SETTINGS</code> frame to the connected HTTP/2 peer.</p>

<p>Once called, the <code>http2session.pendingSettingsAck</code> property will be <code>true</code>

while the session is waiting for the remote peer to acknowledge the new

settings.</p>

<p>The new settings will not become effective until the <code>SETTINGS</code> acknowledgment

is received and the <code>'localSettings'</code> event is emitted. It is possible to send

multiple <code>SETTINGS</code> frames while acknowledgment is still pending.</p>

<h4>http2session.type<span><a class="mark" href="#http2_http2session_type" id="http2_http2session_type">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>

</ul>

<p>The <code>http2session.type</code> will be equal to

<code>http2.constants.NGHTTP2_SESSION_SERVER</code> if this <code>Http2Session</code> instance is a

server, and <code>http2.constants.NGHTTP2_SESSION_CLIENT</code> if the instance is a

client.</p>

<h4>http2session.unref()<span><a class="mark" href="#http2_http2session_unref" id="http2_http2session_unref">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<p>Calls <a href="https://nodejs.org/api/net.html#net_socket_unref"><code>unref()</code></a> on this <code>Http2Session</code>

instance's underlying <a href="https://nodejs.org/api/net.html#net_class_net_socket"><code>net.Socket</code></a>.</p>

<h3>Class: ServerHttp2Session<span><a class="mark" href="#http2_class_serverhttp2session" id="http2_class_serverhttp2session">#</a></span></h3>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li>Extends: <a href="https://nodejs.org/api/http2.html#http2_class_http2session" class="type">&lt;Http2Session&gt;</a></li>

</ul>

<h4>serverhttp2session.altsvc(alt, originOrStream)<span><a class="mark" href="#http2_serverhttp2session_altsvc_alt_originorstream" id="http2_serverhttp2session_altsvc_alt_originorstream">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><code>alt</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> A description of the alternative service configuration as

defined by <a href="https://tools.ietf.org/html/rfc7838">RFC 7838</a>.</li>

<li><code>originOrStream</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> | <a href="https://nodejs.org/api/url.html#url_the_whatwg_url_api" class="type">&lt;URL&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type">&lt;Object&gt;</a> Either a URL string specifying

the origin (or an <code>Object</code> with an <code>origin</code> property) or the numeric

identifier of an active <code>Http2Stream</code> as given by the <code>http2stream.id</code>

property.</li>

</ul>

<p>Submits an <code>ALTSVC</code> frame (as defined by <a href="https://tools.ietf.org/html/rfc7838">RFC 7838</a>) to the connected client.</p>

<pre><code class="language-js">const http2 = require('http2');

const server = http2.createServer();

server.on('session', (session) =&gt; {

// Set altsvc for origin https://example.org:80

session.altsvc('h2=":8000"', 'https://example.org:80');

});

server.on('stream', (stream) =&gt; {

// Set altsvc for a specific stream

stream.session.altsvc('h2=":8000"', stream.id);

});

</code></pre>

<p>Sending an <code>ALTSVC</code> frame with a specific stream ID indicates that the alternate

service is associated with the origin of the given <code>Http2Stream</code>.</p>

<p>The <code>alt</code> and origin string <em>must</em> contain only ASCII bytes and are

strictly interpreted as a sequence of ASCII bytes. The special value <code>'clear'</code>

may be passed to clear any previously set alternative service for a given

domain.</p>

<p>When a string is passed for the <code>originOrStream</code> argument, it will be parsed as

a URL and the origin will be derived. For instance, the origin for the

HTTP URL <code>'https://example.org/foo/bar'</code> is the ASCII string

<code>'https://example.org'</code>. An error will be thrown if either the given string

cannot be parsed as a URL or if a valid origin cannot be derived.</p>

<p>A <code>URL</code> object, or any object with an <code>origin</code> property, may be passed as

<code>originOrStream</code>, in which case the value of the <code>origin</code> property will be

used. The value of the <code>origin</code> property <em>must</em> be a properly serialized

ASCII origin.</p>

<h4>Specifying alternative services<span><a class="mark" href="#http2_specifying_alternative_services" id="http2_specifying_alternative_services">#</a></span></h4>

<p>The format of the <code>alt</code> parameter is strictly defined by <a href="https://tools.ietf.org/html/rfc7838">RFC 7838</a> as an

ASCII string containing a comma-delimited list of "alternative" protocols

associated with a specific host and port.</p>

<p>For example, the value <code>'h2="example.org:81"'</code> indicates that the HTTP/2

protocol is available on the host <code>'example.org'</code> on TCP/IP port 81. The

host and port <em>must</em> be contained within the quote (<code>"</code>) characters.</p>

<p>Multiple alternatives may be specified, for instance: <code>'h2="example.org:81", h2=":82"'</code>.</p>

<p>The protocol identifier (<code>'h2'</code> in the examples) may be any valid

<a href="https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids">ALPN Protocol ID</a>.</p>

<p>The syntax of these values is not validated by the Node.js implementation and

are passed through as provided by the user or received from the peer.</p>

<h4>serverhttp2session.origin(...origins)<span><a class="mark" href="#http2_serverhttp2session_origin_origins" id="http2_serverhttp2session_origin_origins">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v10.12.0</span>

</div>

<ul>

<li><code>origins</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> | <a href="https://nodejs.org/api/url.html#url_the_whatwg_url_api" class="type">&lt;URL&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type">&lt;Object&gt;</a> One or more URL Strings passed as

separate arguments.</li>

</ul>

<p>Submits an <code>ORIGIN</code> frame (as defined by <a href="https://tools.ietf.org/html/rfc8336">RFC 8336</a>) to the connected client

to advertise the set of origins for which the server is capable of providing

authoritative responses.</p>

<pre><code class="language-js">const http2 = require('http2');

const options = getSecureOptionsSomehow();

const server = http2.createSecureServer(options);

server.on('stream', (stream) =&gt; {

stream.respond();

stream.end('ok');

});

server.on('session', (session) =&gt; {

session.origin('https://example.com', 'https://example.org');

});

</code></pre>

<p>When a string is passed as an <code>origin</code>, it will be parsed as a URL and the

origin will be derived. For instance, the origin for the HTTP URL

<code>'https://example.org/foo/bar'</code> is the ASCII string

<code>'https://example.org'</code>. An error will be thrown if either the given string

cannot be parsed as a URL or if a valid origin cannot be derived.</p>

<p>A <code>URL</code> object, or any object with an <code>origin</code> property, may be passed as

an <code>origin</code>, in which case the value of the <code>origin</code> property will be

used. The value of the <code>origin</code> property <em>must</em> be a properly serialized

ASCII origin.</p>

<p>Alternatively, the <code>origins</code> option may be used when creating a new HTTP/2

server using the <code>http2.createSecureServer()</code> method:</p>

<pre><code class="language-js">const http2 = require('http2');

const options = getSecureOptionsSomehow();

options.origins = ['https://example.com', 'https://example.org'];

const server = http2.createSecureServer(options);

server.on('stream', (stream) =&gt; {

stream.respond();

stream.end('ok');

});

</code></pre>

<h3>Class: ClientHttp2Session<span><a class="mark" href="#http2_class_clienthttp2session" id="http2_class_clienthttp2session">#</a></span></h3>

<div class="api_metadata">

<span>Added in: v8.4.0</span>

</div>

<ul>

<li>Extends: <a href="https://nodejs.org/api/http2.html#http2_class_http2session" class="type">&lt;Http2Session&gt;</a></li>

</ul>

<h4>Event: 'altsvc'<span><a class="mark" href="#http2_event_altsvc" id="http2_event_altsvc">#</a></span></h4>

<div class="api_metadata">

<span>Added in: v9.4.0</span>

</div>

<ul>

<li><code>alt</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>

<li><code>origin</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>

<li><code>streamId</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>

</ul>

<p>The <code>'altsvc'</code> event is emitted whenever an <code>ALTSVC</code> frame is received by

the client. The event is emitted with the <code>ALTSVC</code> value, origin, and stream

ID. If no <code>origin</code> is provided in the <code>ALTSVC</code> frame, <code>origin</code> will

be an empty string.</p>