Производительность: метод setResourceTimingBufferSize()

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2015 года.

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

Метод setResourceTimingBufferSize() задаёт желаемый размер буфера отслеживания ресурсов браузера, который хранит "resource" записи производительности.

Спецификация требует, чтобы буфер отслеживания ресурсов изначально был размером 250 или больше.

Для очистки буфера данных производительности ресурсов браузера используйте метод Performance.clearResourceTimings().

Чтобы получать уведомления о том, что буфер отслеживания ресурсов браузера заполнен, подпишитесь на событие resourcetimingbufferfull.

Синтаксис

setResourceTimingBufferSize(maxSize)

Параметры

maxSize: Значение, представляющее максимальное количество объектов PerformanceEntry, которые браузер должен хранить в буфере записей производительности.

Возвращаемое значение

None (undefined).

Примеры

Установка размера буфера отслеживания ресурсов

Следующий вызов позволяет хранить 500 "resource" записей производительности в временной шкале производительности браузера.

performance.setResourceTimingBufferSize(500);

Если вы установите размер буфера меньше, чем текущее количество записей в буфере, записи не будут удалены. Для очистки буфера вызовите Performance.clearResourceTimings().

performance.getEntriesByType("resource").length; // 20
performance.setResourceTimingBufferSize(10);
performance.getEntriesByType("resource").length; // 20

performance.clearResourceTimings();
performance.getEntriesByType("resource").length; // 0

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

Спецификация
Отслеживание ресурсов # dom-performance-setresourcetimingbuffersize

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setResourceTimingBufferSize`	4622–57	12	35	3315–44	11	4625–57	35	3314–43	11	5.01.5–7.0	464.4–57

См. также

© 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/Performance/setResourceTimingBufferSize