Performance

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨сентябрь 2015 г.⁩.

* Some parts of this feature may have varying levels of support.

ИнтерфейсPerformance представляет информацию о производительности страницы с временными метками.

Объект этого типа может быть получен в результате вызова атрибутаWindow.performance, доступного только для чтения.

Примечание:Этот интерфейс и его составляющие доступны вфоновых потоках выполнения, за исключением случаев, перечисленных ниже. Заметим, что некоторые доступные части интерфейса ещё не документированы (подробнее см. разделы документацииPerformance Timeline иUser Timing). Также заметим, что временные метки производительности относятся к текущему контексту. Если вы создадите метку в основном потоке (или в другом фоновом потоке), то её нельзя будет увидеть в другом фоновом потоке и наоборот.

Свойства

ИнтерфейсPerformance не наследует никаких других свойств.

Performance.navigationТолько для чтения: ОбъектPerformanceNavigation, представляющий тип навигации в текущем контексте браузера, как, например, количество перенаправлений, которые нужно пройти, чтобы получить ресурс. Not available in workers.

Performance.onresourcetimingbufferfull: Колбэк-функция, реализующая интерфейсEventTarget, вызываемая при наступлении событияresourcetimingbufferfull.

Performance.timingТолько для чтения: ОбъектPerformanceTiming, содержащий информацию о производительности, связанной со временем задержек. Not available in workers.

Методы

ИнтерфейсPerformance не наследует других методов.

Performance.clearMarks(): Удаляет из буфера записей производительности браузера указаннуювременну́ю метку.
Performance.clearMeasures(): Удаляет из буфера записей производительности браузера указанноеизмерение.
Performance.clearResourceTimings(): Удаляет всезаписи о производительности со свойствомentryType равным "resource" из буфера данных производительности браузера.
Performance.getEntries(): Возвращает список объектовPerformanceEntry, руководствуясь переданным аргументомfilter.
Performance.getEntriesByName(): Возвращает список объектовPerformanceEntry, руководствуясь аргументамиname (название) andentry type (тип записи).
Performance.getEntriesByType(): Возвращает список объектовPerformanceEntry переданного, как аргумент,типа записи.
Performance.mark(): Создаётвременну́ю метку с заданным именем вбуфере записей производительности.
Performance.measure(): Создаёт именованнуювременну́ю метку в буфере записей производительности браузера между двумя определёнными метками (известных какstart mark (начальная метка) иend mark (конечная метка), соответственно).
Performance.now(): Возвращает объектDOMHighResTimeStamp, представляющий количество миллисекунд, прошедших с начала момента отсчёта.
Performance.setResourceTimingBufferSize(): Устанавливает размер буфера измерения ресурсов браузера равным указанному числу объектовзаписей производительноститипа "resource".
Performance.toJSON(): Возвращает json объект, представляющий объектPerformance.

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

Specification
High Resolution Time # sec-performance
Performance Timeline # extensions-to-the-performance-interface
Resource Timing # sec-extensions-performance-interface
User Timing # extensions-performance-interface