Node.js http2session.localSettings 方法

http2session.localSettings 方法是 Node.js 中 http2 模块的一个实例方法，用于设置本地 HTTP/2 会话的默认值。本地 HTTP/2 会话是指通过创建 http2.createSecureServer（）方法创建的 HTTP/2 服务器会话。

语法

session.localSettings(settings)

• settings: Object 类型，HTTP/2 设置选项，默认为一个空对象。

返回值

该方法没有返回值。

说明

http2session.localSettings 方法用于设置本地 HTTP/2 会话的默认值。其中，settings 参数可以是一个 Object 类型，用于设置 HTTP/2 配置选项。如果不传递 settings 参数，则默认空对象。

在本地 HTTP/2 会话期间，可以通过发送 SETTING 帧来更改 HTTP/2 的默认配置。这些默认配置通常由服务器提供，但是可以通过该方法设置本地默认值。

在设置完本地 HTTP/2 会话的默认值后，可以通过调用 session.settings 方法查询会话的当前状态并检查https://www.iana.org/assignments/http2-parameters/http2-parameters.xhtml" 中定义的 HTTP/2 配置选项。

示例

以下是一个使用 http2session.localSettings 方法设置本地 HTTP/2 会话默认值的示例：

const http2 = require('http2');
const options = {
  key: fs.readFileSync('localhost-privkey.pem'),
  cert: fs.readFileSync('localhost-cert.pem')
};
const server = http2.createSecureServer(options);
server.on('error', (err) => console.error(err));

server.on('stream', (stream, headers, flags) => {
  // Handle requests
});

server.listen(8443, () => {
  const session = server.session;
  session.localSettings({
    enablePush: false,
    maxConcurrentStreams: 1000,
    initialWindowSize: 65535
  });
  console.log(`Listening on port ${server.address().port}`);
});

在上面的示例中，我们设置了本地HTTP/2会话的默认配置，禁用了服务器推送，将最大并发流设置为1000，将初始窗口大小设置为65535。在这里，我们使用 createSecureServer 方法创建了一个 HTTP/2 服务器，并且监听了一个事件流，处理请求。最后，我们通过 server.session 属性访问 http2session 对象，并使用 localSettings 方法设置本地会话默认值。

参考文献

• Node.js http2 模块文档