Protocolo DevTools do Microsoft Edge

  • Artigo

Use o Protocolo DevTools para instrumentar, inspecionar, depurar e criar navegadores de perfil, incluindo o Microsoft Edge. O Protocolo DevTools do Microsoft Edge corresponde às APIs do Protocolo Chrome DevTools. Para obter a documentação de referência, acesse Visualizador de Protocolo do Chrome DevTools.

Observação

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

Todos os métodos com ms os quais foram prefixados no Protocolo de DevTools do Microsoft Edge (EdgeHTML) não têm mais suporte no Protocolo de DevTools do Microsoft Edge.

Usando o Protocolo DevTools

Para anexar um cliente de ferramentas personalizadas 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, você pode iniciar uma instância separada do Microsoft Edge usando um perfil de usuário distinto.

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

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

    http://localhost:9222/json/list

  5. Por fim, conecte-se ao webSocketDebuggerUrl do destino desejado e emita comandos/assine mensagens de evento por meio do servidor de soquete Web DevTools.

Pontos de extremidade HTTP do Protocolo DevTools

O Protocolo DevTools do Microsoft Edge dá suporte aos seguintes pontos de extremidade HTTP.

/json/version

Fornece informações sobre o navegador do computador host e qual versão do Protocolo DevTools ele dá suporte.

Parâmetros

Nenhuma.

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

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

Parâmetros

Nenhuma.

Objeto Return

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

/json/list

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

Parâmetros

Nenhuma.

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

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

Parâmetros

ID de destino

Objeto Return

String("Target is closing")

Ferramentas remotas para o Microsoft Edge (Beta)

Você pode instalar as Ferramentas Remotas do Microsoft Edge (Beta) na Microsoft Store. Este aplicativo permite depurar remotamente o Microsoft Edge em execução em um dispositivo Windows 10 ou posterior do computador de desenvolvimento.

Para saber como configurar seu dispositivo Windows e se conectar a ele no computador de desenvolvimento, confira Introdução à depuração remota de dispositivos Windows.

As Ferramentas Remotas para Microsoft Edge (Beta) usam o mesmo Protocolo DevTools do Microsoft Edge que o DevTools para se comunicar com o Microsoft Edge em execução no dispositivo Windows 10 ou posterior que você deseja depurar. Esse aplicativo apenas prepara /msedge/ e uma ID de processo (pid) antes de cada chamada para o protocolo. Ele dá suporte aos seguintes pontos de extremidade HTTP.

As seções de referência a seguir são para Ferramentas Remotas para Microsoft Edge.

/msedge/json/deviceinfo

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

Parâmetros

Nenhuma.

Objeto Return

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

/msedge/json/list

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

Parâmetros

Nenhuma.

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

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

Parâmetros

Nenhuma.

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

Fornece informações sobre a instância do Microsoft Edge que corresponde ao fornecido [pid] e qual versão do Protocolo DevTools ele dá suporte.

Parâmetros

Nenhuma.

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/

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

Parâmetros

Nenhuma.

Objeto Return

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á usando.

Consulte também