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ć.
Plik manifestu
Aby można było używać tego interfejsu API, następujące klucze muszą być zadeklarowane w pliku manifestu.
"devtools_page"
Zobacz podsumowanie interfejsów API DevTools, aby uzyskać ogólne informacje o korzystaniu z interfejsów API Narzędzi dla programistów.
Przegląd
Informacje o żądaniach sieciowych są przekazywane w formacie archiwum HTTP (HAR). Opis pliku HAR wykracza poza zakres tego dokumentu. Zapoznaj się ze specyfikacją 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ć.
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
-
funkcja
Parametr
callback
wygląda tak:(url: string) => void
-
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
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(request: Request) => void
-
Poproś
-