当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Node.js Http2Session.ping([payload, ]callback)用法及代码示例


http2session.ping([payload, ]callback)

历史
版本变化
v18.0.0

将无效回调传递给 callback 参数现在会抛出 ERR_INVALID_ARG_TYPE 而不是 ERR_INVALID_CALLBACK

v8.9.3

添加于:v8.9.3


参数

向连接的 HTTP/2 对等方发送 PING 帧。必须提供callback 函数。如果发送了PING,则该方法将返回true,否则返回false

未完成(未确认)ping 的最大数量由maxOutstandingPings 配置选项确定。默认最大值为 10。

如果提供,payload 必须是 BufferTypedArrayDataView 包含 8 个字节的数据,这些数据将与 PING 一起传输并与 ping 确认一起返回。

回调将使用三个参数调用:如果成功确认 PING,则错误参数将是 null,报告自发送 ping 并收到确认以来经过的毫秒数的 duration 参数,和一个包含 8 字节 PING 有效载荷的 Buffer

session.ping(Buffer.from('abcdefgh'), (err, duration, payload) => {
  if (!err) {
    console.log(`Ping acknowledged in ${duration} milliseconds`);
    console.log(`With payload '${payload.toString()}'`);
  }
});

如果未指定 payload 参数,则默认有效负载将是标记 PING 持续时间开始的 64 位时间戳(小端序)。

相关用法


注:本文由纯净天空筛选整理自nodejs.org大神的英文原创作品 Http2Session.ping([payload, ]callback)。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。