chrome.devtools.network

Opis

Interfejs API chrome.devtools.network służy do pobierania informacji o żądaniach sieciowych wyświetlanych przez Narzędzia dla deweloperów w panelu Sieć.

Informacje o żądaniach sieciowych są przekazywane w formacie archiwum HTTP (HAR). Opis pliku HAR wykracza poza zakres tego dokumentu – patrz specyfikacja HAR w wersji 1.2.

W przypadku danych HAR metoda chrome.devtools.network.getHAR() zwraca cały dziennik HAR, a zdarzenie chrome.devtools.network.onRequestFinished dostarcza wpis HAR jako argument wywołania zwrotnego zdarzenia.

Pamiętaj, że ze względu na wydajność treść żądania nie jest dostarczana jako część HAR. Aby pobrać treści, możesz wywołać metodę getContent() żądania.

Jeśli po załadowaniu strony okno Narzędzi dla deweloperów zostanie otwarte, w tablicy wpisów zwróconych przez getHAR() może brakować niektórych żądań. Aby zobaczyć wszystkie żądania, odśwież stronę. Ogólnie lista żądań zwracanych przez funkcję getHAR() powinna być zgodna z listą wyświetlaną w panelu Sieć.

Zobacz podsumowanie interfejsów API DevTools, aby uzyskać ogólne informacje o korzystaniu z interfejsów API Narzędzi dla programistów.

Plik manifestu

Aby można było używać tego interfejsu API, następujące klucze muszą być zadeklarowane w pliku manifestu.

"devtools_page"

Przykłady

Ten kod rejestruje adresy URL wszystkich obrazów o wielkości większej niż 40 KB podczas ładowania:

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) + '"))');
    }
  }
);

Aby wypróbować ten interfejs API, zainstaluj przykłady interfejsu devtools API z repozytorium chrome-extension-samples.

Typy

Request

Reprezentuje żądanie sieciowe dotyczące zasobu dokumentu (skryptu, obrazu itd.). Zapoznaj się ze specyfikacją HAR.

Właściwości

  • getContent

    void

    Zwraca treść odpowiedzi.

    Funkcja getContent wygląda tak: 

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

    • wywołanie zwrotne

      funkcja

      Parametr callback wygląda tak: 

      (content: string,encoding: string)=>void

      • treści, które są

        string,

        Treść odpowiedzi (potencjalnie zakodowana).

      • kodowanie

        string,

        Pusta, jeśli treść nie jest zakodowana. W przeciwnym razie nazwa kodowania jest pusta. Obecnie obsługiwany jest tylko format base64.

Metody

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

Zwraca dziennik HAR zawierający wszystkie znane żądania sieciowe.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (harLog: object)=>void

    • harLog

      obiekt

      Dziennik HAR. Szczegółowe informacje znajdziesz w specyfikacji HAR.

Wydarzenia

onNavigated

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

Uruchamiane, gdy badane okno przechodzi na nową stronę.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (url: string)=>void

    • URL

      string,

onRequestFinished

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

Uruchamiane, gdy żądanie sieciowe zostanie ukończone, a wszystkie dane żądania będą dostępne.

Parametry