browser.devtools.network

Описание

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

Информация о сетевых запросах представлена в формате HTTP Archive (HAR). Описание HAR не входит в область действия этого документа. См. спецификацию HAR версии 1.2.

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

Обратите внимание, что в целях повышения эффективности контент запроса не включается в HAR-файл. Чтобы получить контент, вызовите метод getContent() запроса.

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

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

Манифест

Чтобы использовать этот API, в манифесте нужно объявить следующие ключи:

"devtools_page"

Примеры

Следующий код регистрирует URL всех изображений размером более 40 КБ по мере их загрузки:

browser.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      browser.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Чтобы попробовать этот API, установите примеры API инструментов разработчика из хранилища chrome-extension-samples.

Типы

Request

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

Свойства

  • getContent

    void

    Возвращает контент тела ответа.

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

    () => {...}

    • Возвращает

      Promise<object>

      Chrome 151 и более поздних версий browser.* начиная с Chrome 152

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

Методы

getHAR()

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

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

Возвраты

  • Promise<object>

    Chrome 151 и более поздних версий browser.* начиная с Chrome 152

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

События

onNavigated

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

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

Параметры

  • обратный вызов

    function

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

    (url: string) => void

    • url

      string

onRequestFinished

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

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

Параметры

  • обратный вызов

    function

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

    (request: Request) => void