PerformanceResourceTiming: connectStart-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die connectStart
-Eigenschaft ist nur lesbar und gibt den Timestamp
unmittelbar bevor der User-Agent damit beginnt, die Verbindung zum Server zur Ressourcenerfassung herzustellen, zurück.
Wert
Die connectStart
-Eigenschaft kann die folgenden Werte haben:
- Ein
DOMHighResTimeStamp
unmittelbar bevor der Browser beginnt, die Verbindung zum Server herzustellen, um die Ressource abzurufen. 0
, wenn die Ressource sofort aus einem Cache abgerufen wurde.0
, wenn die Ressource eine cross-origin Anfrage ist und keinTiming-Allow-Origin
HTTP-Antwort-Header verwendet wird.
Beispiele
Messen der TCP-Handshake-Zeit
Die Eigenschaften connectStart
und connectEnd
können verwendet werden, um zu messen, wie lange es dauert, bis der TCP-Handshake erfolgt.
const tcp = entry.connectEnd - entry.connectStart;
Beispiel unter Verwendung eines PerformanceObserver
, der über neue resource
-Performance-Einträge benachrichtigt, während sie in der Performance-Zeitleiste des Browsers erfasst werden. Verwenden Sie die buffered
-Option, um auf Einträge von vor der Erstellung des Observers zuzugreifen.
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
const tcp = entry.connectEnd - entry.connectStart;
if (tcp > 0) {
console.log(`${entry.name}: TCP handshake duration: ${tcp}ms`);
}
});
});
observer.observe({ type: "resource", buffered: true });
Beispiel unter Verwendung von Performance.getEntriesByType()
, das nur resource
-Performance-Einträge anzeigt, die zum Zeitpunkt des Aufrufs dieser Methode in der Performance-Zeitleiste des Browsers vorhanden sind:
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
const tcp = entry.connectEnd - entry.connectStart;
if (tcp > 0) {
console.log(`${entry.name}: TCP handshake duration: ${tcp}ms`);
}
});
Cross-Origin-Zeitinformationen
Wenn der Wert der connectStart
-Eigenschaft 0
ist, könnte die Ressource eine cross-origin Anfrage sein. Um die Anzeige der Cross-Origin-Zeitinformationen zu ermöglichen, muss der Timing-Allow-Origin
HTTP-Antwort-Header gesetzt werden.
Beispielsweise sollte die cross-origin Ressource diesen Header senden, um https://developer.mozilla.org
zu ermöglichen, Zeitdaten zu sehen:
Timing-Allow-Origin: https://developer.mozilla.org
Spezifikationen
Specification |
---|
Resource Timing # dom-performanceresourcetiming-connectstart |
Browser-Kompatibilität
BCD tables only load in the browser