chrome.devtools.network

Описание

Используйте API chrome.devtools.network для получения информации о сетевых запросах, отображаемой инструментами разработчика на панели «Сеть».

Информация о сетевых запросах представлена ​​в формате HTTP Archive ( HAR ). Описание HAR выходит за рамки данного документа; см. спецификацию HAR v1.2 .

Что касается HAR, метод chrome.devtools.network.getHAR() возвращает весь лог HAR , а событие chrome.devtools.network.onRequestFinished передает запись HAR в качестве аргумента в функцию обратного вызова события.

Обратите внимание, что содержимое запроса не предоставляется в составе HAR по соображениям эффективности. Вы можете вызвать метод getContent() объекта request для получения содержимого.

Если окно «Инструменты разработчика» открывается после загрузки страницы, некоторые запросы могут отсутствовать в массиве записей, возвращаемом функцией getHAR() . Перезагрузите страницу, чтобы получить все запросы. Как правило, список запросов, возвращаемый функцией getHAR() , должен совпадать со списком, отображаемым на панели «Сеть».

Для получения общего представления об использовании API инструментов разработчика см. раздел «Краткое описание API инструментов разработчика».

Манифест

Для использования этого API в манифесте необходимо указать следующие ключи.

"devtools_page"

Примеры

Следующий код регистрирует 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 из репозитория chrome-extension-samples .

Типы

Request

Представляет собой сетевой запрос к ресурсу документа (скрипту, изображению и т. д.). См. спецификацию HAR для получения дополнительной информации.

Характеристики

  • получить контент

    пустота

    Возвращает содержимое тела ответа.

    Функция getContent выглядит следующим образом: 

    () => {...}

    • возвраты

      Promise<object>

      В ожидании

      Функция, которая получает тело ответа после завершения запроса.

Методы

getHAR()

chrome.devtools.network.getHAR(): Promise<object>

Возвращает журнал HAR, содержащий все известные сетевые запросы.

Возвраты

  • Promise<object>

    В ожидании

    Функция, которая получает журнал HAR после завершения запроса.

События

onNavigated

chrome.devtools.network.onNavigated.addListener(
  callback: function,
)

Событие срабатывает, когда проверяемое окно переходит на новую страницу.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (url: string) => void

    • url

      нить

onRequestFinished

chrome.devtools.network.onRequestFinished.addListener(
  callback: function,
)

Событие срабатывает, когда сетевой запрос завершен и все данные запроса доступны.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (request: Request) => void