Compartilhar via

Protocolo DevTools do Microsoft Edge

  • Artigo

Utilize o Protocolo DevTools para instrumentar, inspecionar, depurar e criar perfis de browsers, incluindo o Microsoft Edge. O Protocolo DevTools do Microsoft Edge corresponde às APIs do Protocolo DevTools do Chrome. Para obter documentação de referência, aceda ao Visualizador de Protocolos do Chrome DevTools.

Observação

Com a mudança da plataforma Web subjacente do Microsoft Edge para Chromium, o Protocolo DevTools do Microsoft Edge (EdgeHTML) não receberá mais atualizações. No futuro, o Protocolo DevTools do Microsoft Edge corresponderá às APIs do Protocolo DevTools do Chrome.

Todos os métodos com ms prefixos no Protocolo DevTools do Microsoft Edge (EdgeHTML) já não são suportados no Protocolo DevTools do Microsoft Edge.

Utilizar o Protocolo DevTools

Para anexar um cliente de ferramentas personalizado ao Servidor DevTools no Microsoft Edge:

  1. Feche todas as instâncias do Microsoft Edge.

  2. Inicie o Microsoft Edge com a porta de depuração remota.

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

  3. Opcionalmente, pode iniciar uma instância separada do Microsoft Edge com um perfil de utilizador distinto.

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

  4. Em seguida, utilize o ponto final HTTP list para obter uma lista de destinos de página anexáveis.

    http://localhost:9222/json/list

  5. Por fim, ligue-se ao webSocketDebuggerUrl destino pretendido e emita comandos/subscreva mensagens de evento através do servidor de socket Web DevTools.

Pontos finais HTTP do Protocolo DevTools

O Protocolo DevTools do Microsoft Edge suporta os seguintes pontos finais HTTP.

/json/version

Fornece informações sobre o browser do computador anfitrião e qual a versão do Protocolo DevTools que suporta.

Parâmetros

Nenhuma.

Devolver objeto

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

Fornece toda a superfície da API de protocolo serializada como JSON.

Parâmetros

Nenhuma.

Devolver objeto

Objeto JSON que representa a superfície de API disponível para a versão atual do protocolo.

/json/list

Fornece uma lista candidata de destinos de página para depuração.

Parâmetros

Nenhuma.

Devolver objeto

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

Fecha o processo de destino. Por exemplo, no Microsoft Edge, fecha o separador da página.

Parâmetros

ID de Destino

Devolver objeto

String("Target is closing")

Ferramentas Remotas para o Microsoft Edge

Pode instalar as Ferramentas Remotas do Microsoft Edge a partir da Microsoft Store. Esta aplicação permite-lhe depurar remotamente o Microsoft Edge em execução num dispositivo Windows 10 ou posterior a partir do seu computador de desenvolvimento.

Para saber como configurar o seu dispositivo Windows e ligar ao mesmo a partir do seu computador de desenvolvimento, consulte Introdução à depuração remota de dispositivos Windows.

As Ferramentas Remotas para Microsoft Edge utilizam o mesmo Protocolo DevTools do Microsoft Edge que o DevTools para comunicar com o Microsoft Edge em execução no dispositivo Windows 10 ou posterior que pretende depurar. Esta aplicação apenas prepara /msedge/ e um ID de processo (pid) antes de cada chamada para o protocolo. Suporta os seguintes pontos finais HTTP.

As secções de Referência seguintes destinam-se a Ferramentas Remotas para o Microsoft Edge.

/msedge/json/deviceinfo

Fornece informações sobre o PC Windows ou HoloLens 2 dispositivo ligado para depuração remota.

Parâmetros

Nenhuma.

Devolver objeto

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

/msedge/json/list

Fornece uma lista candidata de todos os processos de Runtime do Microsoft Edge e WebView2 em execução no dispositivo ligado (incluindo PWAs) e todos os separadores ou destinos em cada processo disponível para depuração.

Parâmetros

Nenhuma.

Devolver objeto

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

Fornece uma lista candidata de destinos de página para a instância do Microsoft Edge que corresponde ao fornecido [pid] para depuração.

Parâmetros

Nenhuma.

Devolver objeto

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

Fornece informações sobre a instância do Microsoft Edge que corresponde à versão fornecida [pid] e à versão do Protocolo DevTools que suporta.

Parâmetros

Nenhuma.

Devolver objeto

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

Fornece toda a superfície da API de protocolo serializada como JSON para a instância do Microsoft Edge que corresponde à fornecida [pid].

Parâmetros

Nenhuma.

Devolver objeto

Objeto JSON que representa a superfície de API disponível para a versão do protocolo que a instância do Microsoft Edge que corresponde ao fornecido [pid] está a utilizar.

Consulte também