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()，這將引發錯誤。