Описание
Используйте API chrome.devtools.network
для получения информации о сетевых запросах, отображаемой инструментами разработчика на панели «Сеть».
Информация о сетевых запросах представлена в формате HTTP-архива ( HAR ). Описание HAR выходит за рамки данного документа, см. Спецификацию HAR v1.2 .
С точки зрения HAR, метод chrome.devtools.network.getHAR()
возвращает весь журнал HAR , а событие chrome.devtools.network.onRequestFinished
предоставляет запись HAR в качестве аргумента для обратного вызова события.
Обратите внимание, что содержимое запроса не предоставляется как часть HAR по соображениям эффективности. Вы можете вызвать метод getContent()
запроса для получения контента.
Если окно «Инструменты разработчика» открывается после загрузки страницы, некоторые запросы могут отсутствовать в массиве записей, возвращаемом getHAR()
. Перезагрузите страницу, чтобы получить все запросы. В общем, список запросов, возвращаемых getHAR()
должен совпадать со списком, отображаемым на панели «Сеть».
Общие сведения об использовании API инструментов инструментов разработчика см. в обзоре API-интерфейсов DevTools .
Манифест
Примеры
Следующий код регистрирует URL-адреса всех изображений размером более 40 КБ по мере их загрузки:
chrome.devtools.network.onRequestFinished.addListener(
function(request) {
if (request.response.bodySize > 40*1024) {
chrome.devtools.inspectedWindow.eval(
'console.log("Large image: " + unescape("' +
escape(request.request.url) + '"))');
}
}
);
Чтобы попробовать этот API, установите примеры API devtools из репозитория chrome-extension-samples .
Типы
Request
Представляет сетевой запрос ресурса документа (сценария, изображения и т. д.). См. спецификацию HAR для справки.
Характеристики
- получить контент
пустота
Возвращает содержимое тела ответа.
Функция
getContent
выглядит так:(callback: function) => {...}
- перезвонить
функция
Параметр
callback
выглядит так:(content: string, encoding: string) => void
- содержание
нить
Содержимое тела ответа (возможно, закодированное).
- кодирование
нить
Пусто, если содержимое не закодировано, в противном случае — имя кодировки. В настоящее время поддерживается только base64.
Методы
getHAR()
chrome.devtools.network.getHAR(
callback: function,
)
Возвращает журнал HAR, содержащий все известные сетевые запросы.
Параметры
- перезвонить
функция
Параметр
callback
выглядит так:(harLog: object) => void
- harLog
объект
Журнал HAR. Подробности см. в спецификации HAR.
События
onNavigated
chrome.devtools.network.onNavigated.addListener(
callback: function,
)
Вызывается, когда проверяемое окно переходит на новую страницу.
Параметры
функция
Параметр
callback
выглядит так:(url: string) => void
нить
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
Запускается, когда сетевой запрос завершен и все данные запроса доступны.