PerformanceServerTiming: свойство description

Базовая линия 2023

Новое свойство

С марта 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, она не будет работать на старых устройствах или браузерах.

Примечание: Эта функция доступна в Потоках Web Workers.

Чтение только свойство description возвращает строковое значение описания метрики, заданной сервером, или пустую строку.

Значение

Строка.

Примеры

Запись записей серверного тайминга

Для метрик серверного тайминга сервер должен отправить заголовок Server-Timing. Например:

Server-Timing: cache;desc="Cache Read";dur=23.2

Записи serverTiming могут храниться в записях navigation и resource.

Пример с использованием PerformanceObserver, который уведомляет о новых записях производительности navigation и resource по мере их записи в таймлайне производительности браузера. Используйте опцию buffered для доступа к записям, созданным до создания наблюдателя.

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 }),
);

Пример с использованием Performance.getEntriesByType(), который отображает только записи производительности navigation и resource , присутствующие в таймлайне производительности браузера на момент вызова этого метода:

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"
      }
    }
  }
}

Спецификации

Спецификация
Серверный тайминг # dom-performanceservertiming-description

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`description`	65	79	61	52	16.4	65	61	47	16.4	9.0	65

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PerformanceServerTiming/description