Protocole Microsoft Edge DevTools

  • Article

Utilisez le protocole DevTools pour instrumenter, inspecter, déboguer et profiler les navigateurs, y compris Microsoft Edge. Le protocole Microsoft Edge DevTools correspond aux API du protocole Chrome DevTools. Pour obtenir de la documentation de référence, accédez à Visionneuse de protocole Chrome DevTools.

Remarque

Avec le passage de la plateforme web sous-jacente de Microsoft Edge à Chromium, le protocole DevTools Microsoft Edge (EdgeHTML) ne recevra plus de mises à jour. À l’avenir, le protocole Microsoft Edge DevTools correspondra aux API du protocole Chrome DevTools.

Toutes les méthodes qui étaient préfixées avec ms dans le protocole DevTools Microsoft Edge (EdgeHTML) ne sont plus prises en charge dans le protocole Microsoft Edge DevTools.

Utilisation du protocole DevTools

Pour attacher un client d’outils personnalisés au serveur DevTools dans Microsoft Edge :

  1. Fermez toutes les instances de Microsoft Edge.

  2. Lancez Microsoft Edge avec le port de débogage distant.

    msedge.exe --remote-debugging-port=9222

  3. Si vous le souhaitez, vous pouvez démarrer un instance distinct de Microsoft Edge à l’aide d’un profil utilisateur distinct.

    msedge.exe --user-data-dir=<some directory>

  4. Ensuite, utilisez le point de terminaison HTTP list pour obtenir la liste des cibles de page pouvant être jointes.

    http://localhost:9222/json/list

  5. Enfin, connectez-vous au webSocketDebuggerUrl de la cible souhaitée et émettez des commandes/s’abonner aux messages d’événement via le serveur de socket web DevTools.

Points de terminaison HTTP du protocole DevTools

Le protocole Microsoft Edge DevTools prend en charge les points de terminaison HTTP suivants.

/json/version

Fournit des informations sur le navigateur de l’ordinateur hôte et la version du protocole DevTools qu’il prend en charge.

Parameters

Aucune.

Objet de retour

{
   "Browser": "Edg/75.0.115.0",
   "Protocol-Version": "1.3",
   "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3739.0 Safari/537.36 Edg/75.0.115.0",
   "V8-Version": "7.5.98",
   "WebKit-Version": "537.36 (@68a98f73c7d0f766fb5a013ea7f8dbb41089bc1b)",
   "webSocketDebuggerUrl": "ws://localhost:9222/devtools/browser/a9d0e8cf-476a-4a89-bba9-0fc27ce691cd"
}

/json/protocol

Fournit la surface d’API de protocole entière sérialisée au format JSON.

Parameters

Aucune.

Objet de retour

Objet JSON qui représente la surface d’API disponible pour la version actuelle du protocole.

/json/list

Fournit une liste candidate de cibles de page pour le débogage.

Parameters

Aucune.

Objet de retour

[{
   "description": "",
   "devtoolsFrontendUrl": "/devtools/inspector.html?ws=localhost:9222/devtools/page/AB07C11A262D1EC8634EB12E2DCA4989",
   "id": "AB07C11A262D1EC8634EB12E2DCA4989",
   "title": "localhost:9222/json/protocol",
   "type": "page",
   "url": "http://localhost:9222/json/list",
   "webSocketDebuggerUrl": "ws://localhost:9222/devtools/page/AB07C11A262D1EC8634EB12E2DCA4989"
}, ...  ]

/json/close

Ferme le processus cible. Par exemple, dans Microsoft Edge, ferme l’onglet de la page.

Parameters

ID cible

Objet de retour

String("Target is closing")

Outils à distance pour Microsoft Edge (bêta)

Vous pouvez installer les Outils à distance pour Microsoft Edge (bêta) à partir du Microsoft Store. Cette application vous permet de déboguer à distance Microsoft Edge s’exécutant sur un appareil Windows 10 ou version ultérieure à partir de votre ordinateur de développement.

Pour savoir comment configurer votre appareil Windows et vous y connecter à partir de votre ordinateur de développement, consultez Prise en main du débogage à distance des appareils Windows.

Les Outils à distance pour Microsoft Edge (bêta) utilisent le même protocole Microsoft Edge DevTools que DevTools pour communiquer avec Microsoft Edge en cours d’exécution sur l’appareil Windows 10 ou ultérieur que vous souhaitez déboguer. Cette application ajoute /msedge/ simplement un ID de processus (pid) avant chaque appel au protocole. Il prend en charge les points de terminaison HTTP suivants.

Les sections de référence suivantes concernent les Outils à distance pour Microsoft Edge.

/msedge/json/deviceinfo

Fournit des informations sur le PC Windows ou HoloLens 2 appareil connecté pour le débogage à distance.

Parameters

Aucune.

Objet de retour

{
  "deviceName": "WINDOWS-10-DEV"
}

/msedge/json/list

Fournit une liste de candidats de tous les processus d’exécution Microsoft Edge et WebView2 en cours d’exécution sur l’appareil connecté (y compris les PWA) et tous les onglets ou cibles de chaque processus disponibles pour le débogage.

Parameters

Aucune.

Objet de retour

[
  {
    "version": {
      "Browser": "Edg/110.0.1548.0",
      "Protocol-Version": "1.3",
      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36 Edg/110.0.1548.0",
      "V8-Version": "11.0.6",
      "WebKit-Version": "537.36 (@d6d5aea402510697e05382293a4c6d3da0183736)",
      "webSocketDebuggerUrl": "wss://172.17.75.195:50443/msedge/23416/devtools/browser/f02cc852-644a-48ce-932b-481aa43d8121"
    },
    "info": {
      "browserProcessId": 23416
    },
    "targets": [
      {
        "description": "",
        "devtoolsFrontendUrl": "https://devtools.azureedge.net/serve_file/@d6d5aea402510697e05382293a4c6d3da0183736/inspector.html?wss=172.17.75.195:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE",
        "faviconUrl": "https://learn.microsoft.com/favicon.ico",
        "id": "2AE2506D9FDB1C541FB36DD908ED51DE",
        "title": "Remotely debug Windows devices - Microsoft Edge Developer documentation | Microsoft Learn",
        "type": "page",
        "url": "https://learn.microsoft.com/microsoft-edge/devtools-guide-chromium/remote-debugging/windows",
        "webSocketDebuggerUrl": "wss://172.17.75.195:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE"
      },
      ...
    ]
  },
  ...
]

/msedge/

Fonctionnellement équivalent à /msedge/json/list.

/msedge/[pid]/json/list

Fournit une liste de cibles de page candidates pour le instance Microsoft Edge qui correspond au fourni [pid] pour le débogage.

Parameters

Aucune.

Objet de retour

[
  {
    "description": "",
    "devtoolsFrontendUrl": "/msedge/23416/devtools/inspector.html?wss=localhost:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE",
    "faviconUrl": "https://learn.microsoft.com/favicon.ico",
    "id": "2AE2506D9FDB1C541FB36DD908ED51DE",
    "title": "Remotely debug Windows devices - Microsoft Edge Developer documentation | Microsoft Learn",
    "type": "page",
    "url": "https://learn.microsoft.com/microsoft-edge/devtools-guide-chromium/remote-debugging/windows",
    "webSocketDebuggerUrl": "wss://localhost:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE"
  },
  ...
]

/msedge/[pid]/json/version

Fournit des informations sur le instance Microsoft Edge qui correspond au fourni [pid] et la version du protocole DevTools qu’il prend en charge.

Parameters

Aucune.

Objet de retour

{
  "Browser": "Edg/110.0.1548.0",
  "Protocol-Version": "1.3",
  "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36 Edg/110.0.1548.0",
  "V8-Version": "11.0.6",
  "WebKit-Version": "537.36 (@d6d5aea402510697e05382293a4c6d3da0183736)",
  "webSocketDebuggerUrl": "wss://localhost:50443/msedge/23416/devtools/browser/f02cc852-644a-48ce-932b-481aa43d8121"
}

/msedge/[pid]/json/protocol/

Fournit l’ensemble de la surface d’API de protocole sérialisée au format JSON pour le instance Microsoft Edge qui correspond au fourni[pid].

Parameters

Aucune.

Objet de retour

Objet JSON qui représente la surface d’API disponible pour la version du protocole que microsoft Edge instance qui correspond au fourni [pid] utilise.

Voir également