Utilisez le surveillant de protocole pour afficher toutes les requêtes et réponses CDP effectuées par DevTools, et envoyer directement des commandes CDP.
Présentation
Les outils pour les développeurs Chrome utilisent le protocole Chrome DevTools (CDP) pour instrumenter, inspecter, déboguer et profiler les navigateurs Chrome. Les développeurs peuvent utiliser le surveillant de protocole pour utiliser le CDP par programmation.
Le moniteur de protocole vous permet d'effectuer les opérations suivantes:
- Enregistrer les requêtes et les réponses du CDP
- Inspecter les messages du CDP
- Enregistrer les messages du CDP
- Envoyer des commandes CDP
Ouvrir le moniteur de protocole
Pour ouvrir le surveillant de protocole, procédez comme suit:
Assurez-vous que le test est activé. Cochez la case Protocol Monitor (Surveillance du protocole) sous Settings (Paramètres > Paramètres) > Experiments (Tests).
Pour ouvrir le menu Command (Commande), appuyez sur:
- macOS: Command+Maj+P
- Windows, Linux et ChromeOS: Ctrl+Maj+P
Commencez à saisir
Protocol monitor, sélectionnez Afficher le moniteur de protocole, puis appuyez sur Entrée. DevTools affiche le panneau Protocol monitor (Surveillance du protocole) en bas de la fenêtre DevTools.
Vous pouvez également sélectionner Autres options > Plus d'outils > Surveillance des protocoles en haut à droite.
Enregistrer les requêtes et les réponses du CDP
Lorsque vous ouvrez le surveillant de protocole, il commence automatiquement à enregistrer les messages CDP à partir de la page actuelle. Le surveillant de protocole continue l'enregistrement même si vous actualisez la page ou fermez DevTools.
Pour arrêter ou démarrer l'enregistrement, cliquez sur le bouton d'enregistrement à gauche de la barre d'action en haut du panneau.
Inspecter les messages du CDP
Les messages CDP sont enregistrés dans un tableau sur le côté gauche du panneau, comme le montre l'Observateur de protocole.
Cliquez sur une cellule Méthode, Requête ou Réponse pour afficher une vue détaillée de ses données Requête ou Réponse sur le côté droit du panneau.
Passez des données de requête à celles de réponse en cliquant sur l'onglet d'en-tête correspondant.
Effectuer un clic droit sur une valeur dans la colonne Méthode vous permet d'obtenir 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 dans la barre d'action.
Pour télécharger les messages enregistrés au format JSON, cliquez sur .
Envoyer des commandes CDP brutes
Il existe deux principales façons d'envoyer une commande CDP via le moniteur de protocole:
Si la commande ne nécessite aucun paramètre, saisissez-la dans le champ de saisie en bas de l'Observateur de protocole, puis appuyez sur Entrée (par exemple,
Page.captureScreenshot).Si la commande nécessite des paramètres, fournissez-les au format JSON, par exemple
{"cmd":"Page.captureScreenshot","args":{"format": "jpeg"}}.Le menu déroulant situé à droite du champ de saisie spécifie la cible.
Vous pouvez également utiliser l'éditeur CDP pour modifier et émettre des commandes:
- Ouvrez l'éditeur de commandes en cliquant sur le bouton Afficher l'éditeur de commandes CDP à côté du champ de saisie de commande.
- 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 comptez utiliser.
- 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.
- Envoyez la commande en cliquant sur le bouton Envoyer la commande ou en appuyant sur Ctrl + Entrée.
Vous pouvez également modifier et renvoyer des commandes à partir du tableau. Effectuez un clic droit sur un élément du tableau, puis sélectionnez "Modifier et renvoyer" dans le menu déroulant. L'éditeur CDP s'ouvre alors automatiquement et est 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 CDP (Chrome Devtools Protocol) avec le nouvel éditeur de commandes.