Protocolo DevTools de Microsoft Edge

  • Artículo

Use el protocolo DevTools para instrumentar, inspeccionar, depurar y generar perfiles en exploradores, incluido Microsoft Edge. El protocolo DevTools de Microsoft Edge coincide con las API del protocolo Chrome DevTools. Para obtener documentación de referencia, vaya al Visor de protocolos de Chrome DevTools.

Nota

Con el cambio en la plataforma web subyacente de Microsoft Edge a Chromium, el protocolo DevTools de Microsoft Edge (EdgeHTML) no recibirá más actualizaciones. En el futuro, el protocolo DevTools de Microsoft Edge coincidirá con las API del protocolo Chrome DevTools.

Los métodos con ms el prefijo del protocolo DevTools de Microsoft Edge (EdgeHTML) ya no se admiten en el protocolo Microsoft Edge DevTools.

Uso del protocolo DevTools

Para adjuntar un cliente de herramientas personalizado al servidor de DevTools en Microsoft Edge:

  1. Cierre todas las instancias de Microsoft Edge.

  2. Inicie Microsoft Edge con el puerto de depuración remota.

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

  3. Opcionalmente, puede iniciar una instancia independiente de Microsoft Edge mediante un perfil de usuario distinto.

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

  4. A continuación, use el punto de conexión HTTP list para obtener una lista de destinos de página adjuntables.

    http://localhost:9222/json/list

  5. Por último, conéctese al webSocketDebuggerUrl del destino deseado y emita comandos o suscríbase a mensajes de evento a través del servidor de socket web DevTools.

Puntos de conexión HTTP del protocolo DevTools

El protocolo DevTools de Microsoft Edge admite los siguientes puntos de conexión HTTP.

/json/version

Proporciona información sobre el explorador de la máquina host y qué versión del protocolo DevTools admite.

Parameters

Ninguna.

Objeto Return

{
   "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

Proporciona toda la superficie de API de protocolo serializada como JSON.

Parameters

Ninguna.

Objeto Return

Objeto JSON que representa la superficie de API disponible para la versión actual del protocolo.

/json/list

Proporciona una lista candidata de destinos de página para la depuración.

Parameters

Ninguna.

Objeto Return

[{
   "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

Cierra el proceso de destino. Por ejemplo, en Microsoft Edge, cierra la pestaña de página.

Parameters

Id. de destino

Objeto Return

String("Target is closing")

Herramientas remotas para Microsoft Edge (beta)

Puede instalar herramientas remotas para Microsoft Edge (beta) desde Microsoft Store. Esta aplicación le permite depurar de forma remota Microsoft Edge que se ejecuta en un dispositivo Windows 10 o posterior desde la máquina de desarrollo.

Para obtener información sobre cómo configurar el dispositivo Windows y conectarse a él desde la máquina de desarrollo, consulte Introducción a la depuración remota de dispositivos Windows.

Herramientas remotas para Microsoft Edge (beta) usa el mismo protocolo DevTools de Microsoft Edge que DevTools para comunicarse con Microsoft Edge que se ejecuta en el dispositivo Windows 10 o posterior que desea depurar. Esta aplicación simplemente antepone /msedge/ y un identificador de proceso (pid) antes de cada llamada al protocolo. Admite los siguientes puntos de conexión HTTP.

Las siguientes secciones de referencia son para Herramientas remotas para Microsoft Edge.

/msedge/json/deviceinfo

Proporciona información sobre el equipo Windows o HoloLens 2 dispositivo conectado para la depuración remota.

Parameters

Ninguna.

Objeto Return

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

/msedge/json/list

Proporciona una lista candidata de todos los procesos en tiempo de ejecución de Microsoft Edge y WebView2 que se ejecutan en el dispositivo conectado (incluidos los PWA) y todas las pestañas o destinos de cada proceso disponible para la depuración.

Parameters

Ninguna.

Objeto Return

[
  {
    "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/

Funcionalmente equivalente a /msedge/json/list.

/msedge/[pid]/json/list

Proporciona una lista candidata de destinos de página para la instancia de Microsoft Edge que coincide con la proporcionada [pid] para la depuración.

Parameters

Ninguna.

Objeto Return

[
  {
    "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

Proporciona información sobre la instancia de Microsoft Edge que coincide con la proporcionada [pid] y la versión del protocolo DevTools que admite.

Parameters

Ninguna.

Objeto Return

{
  "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/

Proporciona toda la superficie de API de protocolo serializada como JSON para la instancia de Microsoft Edge que coincide con el proporcionado [pid].

Parameters

Ninguna.

Objeto Return

Objeto JSON que representa la superficie de API disponible para la versión del protocolo que usa la instancia de Microsoft Edge que coincide con la proporcionada [pid] .

Ver también