Surveillance des protocoles: afficher et envoyer des requêtes CDP

Dale St. Marthe
Dale St. Marthe

Utilisez l'outil de surveillance de protocole pour afficher toutes les requêtes et réponses CDP effectuées par les outils de développement, et envoyer directement des commandes CDP.

Présentation

Les outils pour les développeurs Chrome utilisent le CDP (Chrome DevTools Protocol) pour instrumenter, inspecter, déboguer et profiler les navigateurs Chrome. Les développeurs peuvent utiliser le moniteur de protocole pour travailler avec la CDP de manière programmatique.

La surveillance de protocole vous permet d'effectuer les opérations suivantes:

  • Enregistrer les requêtes et les réponses CDP
  • Inspecter les messages CDP
  • Enregistrer les messages CDP
  • Envoyer des commandes CDP

Ouvrir le moniteur de protocole

Pour ouvrir l'Moniteur de protocole, procédez comme suit:

  1. Assurez-vous que le test est activé. Cochez la case Moniteur de protocole sous Paramètres > Paramètres > Tests.

  2. Ouvrez le menu Commande en appuyant sur:

    • macOS: Commande+Maj+P
    • Windows, Linux, ChromeOS: Ctrl+Maj+P Menu de commandes avec
  3. Commencez à saisir Protocol monitor, sélectionnez Afficher le moniteur de protocole, puis appuyez sur Entrée. Les outils de développement affichent le panneau Moniteur de protocole en bas de la fenêtre "Outils de développement".

Sinon, dans l'angle supérieur droit, sélectionnez more_vert Plus d'options > Plus d'outils > Moniteur de protocole.

Enregistrer les requêtes et les réponses CDP

Lorsque vous ouvrez l'écran de contrôle du protocole, celui-ci commence automatiquement à enregistrer les messages CDP à partir de la page actuelle. L'écran de contrôle de protocole continue d'enregistrer même si vous actualisez la page ou fermez les outils de développement.

Pour arrêter ou démarrer l'enregistrement, cliquez sur le bouton d'enregistrement à gauche de la barre d'action en haut du panneau.

Bouton d'enregistrement dans le panneau "Surveillance du protocole".

Inspecter les messages CDP

Comme les enregistrements de la surveillance de protocole, les messages CDP sont consignés dans une table à gauche du panneau.

Cliquez sur une cellule Méthode, Requête ou Réponse pour ouvrir une vue détaillée des données de sa requête ou de sa réponse sur le côté droit du panneau.

Méthode mise en évidence dans le panneau "Protocol monitoring" (Surveillance du protocole).

Basculez entre les données de requête et de réponse en cliquant sur l'onglet d'en-tête correspondant.

Vous pouvez effectuer un clic droit sur une valeur de la colonne Méthode pour afficher des options basées sur le contexte.

Effacer et télécharger les messages CDP

Pour effacer tous les messages CDP enregistrés, cliquez sur le bouton EffacerBloquer dans la barre d'action.

Pour télécharger les messages enregistrés sous forme de fichier JSON, cliquez sur Télécharger.

Envoyer des commandes CDP brutes

Il existe deux manières principales d'envoyer une commande CDP via l'écran de contrôle de protocole:

  • Si la commande ne nécessite aucun paramètre, saisissez-la dans le champ de saisie en bas de l'écran Protocol Monitor (Moniteur de protocole), puis appuyez sur Entrée (par exemple, Page.captureScreenshot).

    Si la commande nécessite des paramètres, indiquez-les au format JSON, par exemple {"cmd":"Page.captureScreenshot","args":{"format": "jpeg"}}.

    Le menu déroulant à droite du champ de saisie spécifie la cible.

Menu déroulant "Cible" encadré dans l'outil de surveillance du protocole.

  • Vous pouvez également utiliser l'éditeur de CDN pour modifier et émettre des commandes:

    1. Ouvrez l'éditeur de commandes en cliquant sur le bouton left_panel_open Afficher l'éditeur de commandes CDP à côté du champ de saisie de la commande.
    2. Sélectionnez une cible dans la liste déroulante, puis commencez à saisir une commande CDP à côté de l'invite de commande. La saisie semi-automatique vous propose des options pertinentes. Sélectionnez la commande que vous souhaitez utiliser. Entrée de la commande dans l'outil de surveillance des protocoles.
    3. Une fois que vous avez saisi une commande CDP, l'éditeur crée une forme structurée de paramètres en fonction des définitions de protocole. Renseignez ces paramètres pour les envoyer avec votre commande. Saisie d'un paramètre avec les paramètres liés au service worker listés à remplir.
    4. Envoyez la commande en cliquant sur le bouton Envoyer Envoyer la commande ou en appuyant sur Ctrl + Entrée.

Vous pouvez également modifier et renvoyer des commandes à partir du tableau. Cliquez avec le bouton droit sur un élément du tableau et sélectionnez Modifier et renvoyer dans le menu déroulant. L'éditeur CDP sera automatiquement rouvert et prérempli avec la commande que vous avez sélectionnée.

Pour en savoir plus sur l'éditeur CDP, consultez Créer efficacement vos commandes Chrome Devtools Protocol (CDP) avec le nouvel éditeur de commandes.