Protocolo DevTools do Microsoft Edge

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

Usando 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, 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 destino desejado e emita comandos/assine mensagens de evento por meio do servidor de soquete da Web do DevTools.

Pontos de extremidade HTTP do protocolo DevTools

O protocolo DevTools do Microsoft Edge dá suporte aos pontos de extremidade HTTP a seguir.

/json/version

Fornece informações sobre o navegador do computador host e qual versão do protocolo DevTools ele suporta.

Parâmetros

Nenhuma.

Objeto de retorno

{
   "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 do protocolo serializada como JSON.

Parâmetros

Nenhuma.

Objeto de retorno

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.

Objeto de retorno

[{
   "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 da página.

Parâmetros

ID de Destino

Objeto de retorno

String("Target is closing")

Ferramentas remotas para o Microsoft Edge

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

Para saber como configurar seu dispositivo Windows e conectar-se a ele de seu computador de desenvolvimento, consulte Depurar remotamente dispositivos Windows.

As Ferramentas Remotas para o aplicativo Microsoft Edge usam o mesmo protocolo DevTools do Microsoft Edge usado pelo DevTools do Microsoft Edge, para se comunicar com o Microsoft Edge em execução no dispositivo Windows 10 ou posterior que você deseja depurar. Este aplicativo apenas precede /msedge/ e uma ID de processo (pid) antes de cada chamada para o protocolo.

O aplicativo Ferramentas Remotas para Microsoft Edge dá suporte aos seguintes pontos de extremidade HTTP; as seções de referência abaixo são para Ferramentas Remotas para o Microsoft Edge.

/msedge/json/deviceinfo

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

Parâmetros

Nenhuma.

Objeto de retorno

{
  "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íveis para depuração.

Parâmetros

Nenhuma.

Objeto de retorno

[
  {
    "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/remote-debugging/windows",
        "webSocketDebuggerUrl": "wss://172.17.75.195:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE"
      },
      ...
    ]
  },
  ...
]

Consulte também:

/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 ao fornecido [pid] para depuração.

Parâmetros

Nenhuma.

Objeto de retorno

[
  {
    "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/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 à fornecida [pid] e qual versão do protocolo DevTools ela suporta.

Parâmetros

Nenhuma.

Objeto de retorno

{
  "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 do protocolo serializada como JSON para a instância do Microsoft Edge que corresponde ao fornecido [pid].

Parâmetros

Nenhuma.

Objeto de retorno

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.

EdgeHTML Protocolo DevTools

Com a mudança na plataforma Web subjacente do Microsoft Edge para o 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 prefixados ms no protocolo DevTools Microsoft Edge (EdgeHTML) não são mais compatíveis com o protocolo DevTools Microsoft Edge.

Consulte também

  • Last updated on