doc: remove http2 pushStream weight option

The PRIORITY field is only supported by HTTP/2 in a HEADERS frame
initiated by the client, not in a push request sent by the server.

Documents the recommended approach to set a silent priority as
used internally by nghttp2.

PR-URL: https://github.com/nodejs/node/pull/16451
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Anatoli Papirovski <apapirovski@mac.com>
This commit is contained in:
Sebastiaan Deckers 2017-10-25 02:39:06 +08:00 committed by Anatoli Papirovski
parent c66e5551df
commit a0f7ae6c41
No known key found for this signature in database
GPG Key ID: 614E2E1ABEB4B2C0

View File

@ -989,9 +989,6 @@ added: v8.4.0
Defaults to `false`.
* `parent` {number} Specifies the numeric identifier of a stream the newly
created stream is dependent on.
* `weight` {number} Specifies the relative dependency of a stream in relation
to other streams with the same `parent`. The value is a number between `1`
and `256` (inclusive).
* `callback` {Function} Callback that is called once the push stream has been
initiated.
* Returns: {undefined}
@ -1012,6 +1009,10 @@ server.on('stream', (stream) => {
});
```
Setting the weight of a push stream is not allowed in the `HEADERS` frame. Pass
a `weight` value to `http2stream.priority` with the `silent` option set to
`true` to enable server-side bandwidth balancing between concurrent streams.
#### http2stream.respond([headers[, options]])
<!-- YAML
added: v8.4.0