PerformanceServerTiming: description-Eigenschaft
Baseline 2023
Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die schreibgeschützte description
-Eigenschaft gibt einen Zeichenfolgenwert der vom Server festgelegten Metrikbeschreibung oder eine leere Zeichenfolge zurück.
Wert
Eine Zeichenfolge.
Beispiele
Protokollierung von Server-Timing-Einträgen
Server-Timing-Metriken erfordern, dass der Server den Server-Timing
-Header sendet. Zum Beispiel:
Server-Timing: cache;desc="Cache Read";dur=23.2
Die serverTiming
-Einträge können in navigation
- und resource
-Einträgen vorkommen.
Beispiel mit einem PerformanceObserver
, der über neue navigation
- und resource
-Performance-Einträge benachrichtigt, während diese in der Performance-Zeitleiste des Browsers aufgezeichnet werden. Verwenden Sie die Option buffered
, um auf Einträge zuzugreifen, die vor der Erstellung des Observers existierten.
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-Zeitleiste 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-description |
Browser-Kompatibilität
BCD tables only load in the browser