Description
Utilisez l'API chrome.devtools.network
pour récupérer les informations sur les requêtes réseau affichées par les outils pour les développeurs dans le panneau "Network" (Réseau).
Les informations sur les requêtes réseau sont représentées au format HTTP Archive (HAR). La description de HAR n'entre pas dans le cadre de ce document. Reportez-vous à la spécification HAR v1.2.
En termes de HAR, la méthode chrome.devtools.network.getHAR()
renvoie l'intégralité du journal HAR, tandis que l'événement chrome.devtools.network.onRequestFinished
fournit une entrée HAR comme argument pour le rappel de l'événement.
Pour des raisons d'efficacité, le contenu des requêtes n'est pas fourni dans le fichier HAR. Vous pouvez appeler la méthode getContent()
de la requête pour récupérer le contenu.
Si la fenêtre "Outils de développement" est ouverte après le chargement de la page, certaines requêtes peuvent être manquantes dans le tableau d'entrées renvoyé par getHAR()
. Actualisez la page pour afficher toutes les requêtes. En général, la liste des requêtes renvoyées par getHAR()
doit correspondre à celle affichée dans le panneau "Network" (Réseau).
Consultez le résumé des API DevTools pour obtenir une présentation générale de l'utilisation des API Developer Tools.
Manifest
Les clés suivantes doivent être déclarées dans le fichier manifeste pour utiliser cette API.
"devtools_page"
Exemples
Le code suivant enregistre les URL de toutes les images dont la taille est supérieure à 40 Ko lors de leur chargement:
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) + '"))');
}
}
);
Pour essayer cette API, installez les exemples d'API de développement à partir du dép��t chrome-extension-samples.
Types
Request
Représente une requête réseau pour une ressource de document (script, image, etc.). Reportez-vous à la spécification HAR pour référence.
Propriétés
-
getContent
void
Renvoie le contenu du corps de la réponse.
La fonction
getContent
se présente comme suit :(callback: function) => {...}
-
rappel
function
Le paramètre
callback
se présente comme suit :(content: string, encoding: string) => void
-
de qualité, inédits, adaptés et variés
chaîne
Contenu du corps de la réponse (potentiellement encodé).
-
encoding
chaîne
Ce champ est vide si le contenu n'est pas encodé, et le nom de codage dans le cas contraire. Actuellement, seul le format base64 est accepté.
-
-
Méthodes
getHAR()
chrome.devtools.network.getHAR(
callback: function,
)
Renvoie le journal HAR qui contient toutes les requêtes réseau connues.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(harLog: object) => void
-
harLog
objet
Un journal HAR Pour en savoir plus, consultez la spécification HAR.
-
Événements
onNavigated
chrome.devtools.network.onNavigated.addListener(
callback: function,
)
Déclenché lorsque la fenêtre inspectée accède à une nouvelle page
Paramètres
-
function
Le paramètre
callback
se présente comme suit :(url: string) => void
-
chaîne
-
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
Déclenché lorsqu'une requête réseau est terminée et que toutes les données de la requête sont disponibles