RTCCertificateStats
RTCCertificateStats
是 WebRTC API 的一个字典,用于报告 RTCDtlsTransport
及其底层 RTCIceTransport
使用的证书信息。
可以通过迭代 RTCStatsReport
(由 RTCPeerConnection.getStats()
返回)来获取报告,直到找到 type
为 certificate
的条目。
实例属性
fingerprint
-
包含证书指纹的字符串,该指纹使用
fingerprintAlgorithm
中指定的哈希函数计算得出。 fingerprintAlgorithm
-
包含用于计算证书
fingerprint
的哈希函数的字符串,例如“sha-256”。 base64Certificate
-
包含 DER 编码证书的 Base64 表示形式的字符串。
常用实例属性
以下属性是所有 WebRTC 统计对象共有的(有关更多信息,请参阅 RTCStatsReport
)。
id
-
唯一标识正在监控以生成此统计数据集的对象的字符串。
timestamp
-
一个
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 |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。