Cette page a été traduite par l'API Cloud Translation.

chrome.devtools.network

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

rappel

function

Le paramètre callback se présente comme suit :
```
(url: string)=>void
```
- url
  
  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

Paramètres

rappel

function

Le paramètre callback se présente comme suit :
```
(request: Request)=>void
```
- request
  
  Requête