Node.js ServerHttp2Session.altsvc(alt, originOrStream)用法及代码示例

serverhttp2session.altsvc(alt, originOrStream)

参数

• alt <string> 由 RFC 7838 定义的替代服务配置的说明。
• originOrStream <number> | <string> | <URL> | <Object> 指定来源的 URL 字符串(或带有 origin 属性的 Object)或由 http2stream.id 属性给出的活动 Http2Stream 的数字标识符。

向连接的客户端提交 ALTSVC 帧(由 RFC 7838 定义)。

const http2 = require('node:http2');

const server = http2.createServer();
server.on('session', (session) => {
  // Set altsvc for origin https://example.org:80
  session.altsvc('h2=":8000"', 'https://example.org:80');
});

server.on('stream', (stream) => {
  // Set altsvc for a specific stream
  stream.session.altsvc('h2=":8000"', stream.id);
});

发送具有特定流 ID 的 ALTSVC 帧表示备用服务与给定 Http2Stream 的来源相关联。

alt 和原始字符串必须仅包含 ASCII 字节，并被严格解释为 ASCII 字节序列。可以传递特殊值'clear' 以清除任何先前为给定域设置的替代服务。

当为 originOrStream 参数传递一个字符串时，它将被解析为 URL 并派生源。例如，HTTP URL 'https://example.org/foo/bar' 的来源是 ASCII 字符串 'https://example.org' 。如果给定的字符串无法解析为 URL 或无法派生有效的来源，则会引发错误。

URL 对象或具有 origin 属性的任何对象都可以作为 originOrStream 传递，在这种情况下，将使用 origin 属性的值。 origin 属性的值必须是正确序列化的 ASCII 源。