chrome.devtools.network

Описание

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

Манифест

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

"devtools_page"

Общие сведения об использовании API инструментов инструментов разработчика см. в обзоре API-интерфейсов DevTools .

Обзор

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

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

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

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

Примеры

Следующий код регистрирует 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

    • URL

      нить

onRequestFinished

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

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

Параметры

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

    функция

    Параметр callback выглядит так:

    (request: Request) => void