RTCCertificateStats
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Das RTCCertificateStats-Wörterbuch der WebRTC API wird verwendet, um Informationen über ein von einem RTCDtlsTransport und seinem zugrunde liegenden RTCIceTransport verwendetes Zertifikat zu berichten.
Der Bericht kann erhalten werden, indem man den RTCStatsReport, der von RTCPeerConnection.getStats() zurückgegeben wird, durchläuft, bis man einen Eintrag mit dem type von certificate findet.
Instanzeigenschaften
base64Certificate-
Ein String, der die Base-64-Darstellung des DER-kodierten Zertifikats enthält.
fingerprint-
Ein String, der den Zertifikat-Fingerprint enthält, der mit der in
fingerprintAlgorithmangegebenen Hash-Funktion berechnet wurde. fingerprintAlgorithm-
Ein String, der die Hash-Funktion enthält, die zur Berechnung des Zertifikat-
fingerprintverwendet wird, wie zum Beispiel "sha-256". issuerCertificateId-
Ein String, der die
iddesRTCCertificateStats-Objekts in diesem Bericht enthält, das das nächste Zertifikat in der Zertifikatskette enthält. Dies wird nicht gesetzt, wenn das aktuelle Zertifikat ein selbstsigniertes Zertifikat oder das Ende der Zertifikatskette (ein Root-Zertifikat) ist.
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam (siehe RTCStatsReport für weitere Informationen).
id-
Ein String, der das Objekt, das überwacht wird, um diesen Satz von Statistiken zu erzeugen, eindeutig identifiziert.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Stichprobe für dieses Statistikobjekt genommen wurde. type-
Ein String mit dem Wert
"certificate", der auf den Typ der Statistiken hinweist, die das Objekt enthält.
Beispiele
Grundlegende Verwendung
Gegeben ist eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist. Der untenstehende Code verwendet await, um auf den Statistikbericht zu warten, und durchläuft ihn dann mit RTCStatsReport.forEach(). Anschließend filtert er die Wörterbücher nur für die Berichte, die den Typ certificate haben, und protokolliert das Ergebnis.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "certificate") {
// Log the certificate information
console.log(report);
}
});
Spezifikationen
| Spezifikation |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcstatstype-certificate |