RTCCertificateStats

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

WebRTC API 中的 RTCCertificateStats 字典用于报告由 RTCDtlsTransport 及其底层 RTCIceTransport 使用的证书的信息。

可以通过迭代 RTCPeerConnection.getStats() 返回的 RTCStatsReport 来获取报告,直到找到一个 typecertificate 的条目。

实例属性

fingerprint

一个包含证书指纹的字符串,该指纹使用 fingerprintAlgorithm 中指定的哈希函数进行计算。

fingerprintAlgorithm

一个包含用于计算证书 fingerprint 的哈希函数的字符串,例如 "sha-256"。

base64Certificate

包含 DER 编码证书的 base-64 表示形式的字符串。

常见实例属性

以下属性是所有 WebRTC 统计对象共有的(有关更多信息,请参阅 RTCStatsReport)。

id

一个字符串,唯一标识正在监控以生成这组统计信息的对象。

时间戳

一个 DOMHighResTimeStamp 对象,表示此统计信息对象样本的采集时间。

type

一个值为 "certificate" 的字符串,表示该对象包含的统计信息的类型。

示例

给定一个变量 myPeerConnection,它是 RTCPeerConnection 的一个实例,下面的代码使用 await 等待统计报告,然后使用 RTCStatsReport.forEach() 进行迭代。然后,它过滤字典,只保留类型为 certificate 的报告,并记录结果。

js
const stats = await myPeerConnection.getStats();

stats.forEach((report) => {
  if (report.type === "certificate") {
    // Log the certificate information
    console.log(report);
  }
});

规范

规范
WebRTC 统计 API 的标识符
# dom-rtcstatstype-certificate

浏览器兼容性

另见