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 Réseau.

Fichier manifeste

Les clés suivantes doivent être déclarées dans le fichier manifeste pour utiliser cette API.

"devtools_page"

Pour une introduction générale à l'utilisation des API des outils pour les développeurs, consultez Résumé des API des outils pour les développeurs.

Présentation

Les informations sur les requêtes réseau sont représentées au format HTTP Archive (HAR). La description du format HAR ne fait pas partie du présent document. Veuillez consulter la spécification HAR v1.2.

En termes de format 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 du rappel d'événement.

Notez que le contenu de la requête n'est pas fourni dans le cadre du format HAR pour des raisons d'efficacité. Vous pouvez appeler la méthode getContent() de la requête pour récupérer le contenu.

Si la fenêtre des outils pour les développeurs est ouverte après le chargement de la page, certaines requêtes peuvent être manquantes dans le tableau des entrées renvoyées par getHAR(). Rechargez la page pour obtenir 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 Réseau.

Exemples

Le code suivant enregistre les URL de toutes les images de plus de 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 des outils pour les développeurs à 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.). Pour plus d'informations, consultez la spécification HAR.

Propriétés

  • getContent

    vide

    Promesse

    Renvoie le contenu du corps de la réponse.

    La fonction getContent se présente comme suit : 

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

    • callback

      fonction facultative

      Le paramètre callback se présente comme suit : 

      (response: object) => void

      • réponse

        objet

        Chrome 151+

        Objet contenant le corps de la réponse et son encodage.

        • contenu

          chaîne

          Contenu du corps de la réponse (potentiellement encodé).

        • encodage

          chaîne

          Vide si le contenu n'est pas encodé, sinon nom de l'encodage. Pour le moment, seul le format base64 est compatible.

    • Renvoie

      Promise<object>

      Chrome 151+

      Fonction qui reçoit le corps de la réponse lorsque la requête est terminée.

      Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Méthodes

getHAR()

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

Renvoie le journal HAR contenant toutes les requêtes réseau connues.

Paramètres

  • callback

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (harLog: object) => void

    • harLog

      objet

      Journal HAR. Pour en savoir plus, consultez la spécification HAR.

Renvoie

  • Promise<object>

    Chrome 151+

    Fonction qui reçoit le journal HAR lorsque la requête est terminée.

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

É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

  • callback

    fonction

    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

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (request: Request) => void