PerformanceServerTiming: duration-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte Eigenschaft duration gibt einen double-Wert zurück, der die vom Server angegebene Metrikdauer enthält (normalerweise in Millisekunden), oder den Wert 0.0.
Wert
Eine Zahl.
Beispiele
Protokollierung von Server-Timing-Einträgen
Server-Timing-Metriken erfordern, dass der Server den Header Server-Timing sendet. Zum Beispiel:
Server-Timing: cache;desc="Cache Read";dur=23.2
Die serverTiming-Einträge können bei navigation und resource-Einträgen vorhanden sein.
Beispiel mit einem PerformanceObserver, der benachrichtigt, wenn neue navigation und resource Performance-Einträge in der Performance-Zeitachse des Browsers erfasst werden. Verwenden Sie die buffered-Option, um auf Einträge zuzugreifen, die vor der Erstellung des Observers vorhanden sind.
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
entry.serverTiming.forEach((serverEntry) => {
console.log(
`${serverEntry.name} (${serverEntry.description}) duration: ${serverEntry.duration}`,
);
// Logs "cache (Cache Read) duration: 23.2"
});
});
});
["navigation", "resource"].forEach((type) =>
observer.observe({ type, buffered: true }),
);
Beispiel mit Performance.getEntriesByType(), das nur navigation und resource Performance-Einträge anzeigt, die zum Zeitpunkt des Aufrufs dieser Methode in der Performance-Zeitachse des Browsers vorhanden sind:
for (const entryType of ["navigation", "resource"]) {
for (const { name: url, serverTiming } of performance.getEntriesByType(
entryType,
)) {
if (serverTiming) {
for (const { name, description, duration } of serverTiming) {
console.log(`${name} (${description}) duration: ${duration}`);
// Logs "cache (Cache Read) duration: 23.2"
}
}
}
}
Spezifikationen
| Specification |
|---|
| Server Timing # dom-performanceservertiming-duration |