chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

Описание

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

Манифест

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

"devtools_page"

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

Обзор

Информация о сетевых запросах представлена в формате HTTP Archive (HAR). Описание HAR-файла не входит в область действия этого документа. Ознакомьтесь со спецификацией HAR версии 1.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 инструментов разработчика из хранилища chrome-extension-samples.

Типы

Request

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

Свойства

  • getContent

    void

    Promise

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

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

    (callback?: function) => {...}

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

      function необязательно

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

      (response: object) => void

      • Ответ

        Объект

        Chrome 151+

        Объект, содержащий тело ответа и его кодировку.

        • контент

          string

          Содержимое тела ответа (может быть закодировано).

        • кодирование

          string

          Если контент не закодирован, поле остается пустым. В противном случае указывается название кодировки. В настоящее время поддерживается только base64.

    • Возвращает

      Promise<object>

      Chrome 151+

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

      Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

Методы

getHAR()

Promise 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

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

Параметры

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

    function необязательно

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

    (harLog: object) => void

    • harLog

      Объект

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

Возвраты

  • Promise<object>

    Chrome 151+

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

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onNavigated

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

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

Параметры

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

    function

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

    (url: string) => void

    • url

      string

onRequestFinished

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

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

Параметры

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

    function

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

    (request: Request) => void