http2session.settings([settings][, callback])

版本历史

版本	变更
v18.0.0	将无效回调传给 `callback` 参数现在会抛出 `ERR_INVALID_ARG_TYPE` 而不是 `ERR_INVALID_CALLBACK`。
v8.4.0	新增于: v8.4.0

settings <HTTP/2 Settings Object>
callback <Function> 一旦会话连接或会话已连接时立即调用的回调。
- err <Error> | <null>
- settings <HTTP/2 Settings Object> 更新后的 settings 对象。
- duration <integer>

更新此 Http2Session 的当前本地设置并向连接的 HTTP/2 对等方发送新的 SETTINGS 帧。

一旦调用，当会话等待远程对等方确认新设置时，http2session.pendingSettingsAck 属性将为 true。

在收到 SETTINGS 确认并触发 'localSettings' 事件之前，新设置不会生效。可以在确认未决时发送多个 SETTINGS 帧。

History

Version	Changes
v18.0.0	Passing an invalid callback to the `callback` argument now throws `ERR_INVALID_ARG_TYPE` instead of `ERR_INVALID_CALLBACK`.
v8.4.0	Added in: v8.4.0

settings <HTTP/2 Settings Object>
callback <Function> Callback that is called once the session is connected or right away if the session is already connected.
- err <Error> | <null>
- settings <HTTP/2 Settings Object> The updated settings object.
- duration <integer>

Updates the current local settings for this Http2Session and sends a new SETTINGS frame to the connected HTTP/2 peer.

Once called, the http2session.pendingSettingsAck property will be true while the session is waiting for the remote peer to acknowledge the new settings.

The new settings will not become effective until the SETTINGS acknowledgment is received and the 'localSettings' event is emitted. It is possible to send multiple SETTINGS frames while acknowledgment is still pending.