Node.js ServerHttp2Stream http2stream.pushStream(headers[, options], callback)用法及代码示例

http2stream.pushStream(headers[, options], callback)

参数

• headers <HTTP/2 Headers Object>
• options <Object>
  • exclusive <boolean> 当true 和parent 标识父流时，创建的流成为父流的唯一直接依赖项，所有其他现有依赖项成为新创建流的依赖项。 默认： false 。
  • parent <number> 指定新创建的流所依赖的流的数字标识符。
• callback <Function>启动推送流后调用的回调。
  • err <Error>
  • pushStream <ServerHttp2Stream> 返回的 pushStream 对象。
  • headers <HTTP/2 Headers Object> Headers 对象 pushStream 被启动。

启动推送流。使用为作为第二个参数传递的推送流创建的新 Http2Stream 实例或作为第一个参数传递的 Error 调用回调。

const http2 = require('node:http2');
const server = http2.createServer();
server.on('stream', (stream) => {
  stream.respond({ ':status': 200 });
  stream.pushStream({ ':path': '/' }, (err, pushStream, headers) => {
    if (err) throw err;
    pushStream.respond({ ':status': 200 });
    pushStream.end('some pushed data');
  });
  stream.end('some data');
});

HEADERS帧中不允许设置推流权重。将 weight 值传递给 http2stream.priority 并将 silent 选项设置为 true 以启用并发流之间的服务器端带宽平衡。

不允许从推送的流中调用 http2stream.pushStream()，这将引发错误。