Protocolo DevTools do Microsoft Edge

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 a Documentação de referência, veja Chrome DevTools Protocol Viewer (Visualizador de Protocolos do Chrome DevTools).

Utilizar o Protocolo DevTools

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

Feche todas as instâncias do Microsoft Edge.
Inicie o Microsoft Edge com a porta de depuração remota.
```
msedge.exe --remote-debugging-port=9222
```
Opcionalmente, pode iniciar uma instância separada do Microsoft Edge com um perfil de utilizador distinto.
```
msedge.exe --user-data-dir=<some directory>
```
Em seguida, utilize o ponto final HTTP list para obter uma lista de destinos de página anexáveis.
```
http://localhost:9222/json/list
```
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-se ao mesmo a partir do seu computador de desenvolvimento, consulte Depurar remotamente dispositivos Windows.

A aplicação Ferramentas Remotas para Microsoft Edge utiliza o mesmo Protocolo DevTools do Microsoft Edge utilizado pelas DevTools do Microsoft Edge 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.

A aplicação Ferramentas Remotas para Microsoft Edge suporta os seguintes pontos finais HTTP; as secções de referência abaixo 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/remote-debugging/windows",
        "webSocketDebuggerUrl": "wss://172.17.75.195:50443/msedge/23416/devtools/page/2AE2506D9FDB1C541FB36DD908ED51DE"
      },
      ...
    ]
  },
  ...
]

Consulte também:

Visão geral dos Aplicativos Web Progressivos (PWAs)

/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/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.

Protocolo EdgeHTML DevTools

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.

Consulte também

Protocolo Chrome DevTools
Protocolo CDP (Chrome DevTools Protocol) em Descrição Geral das APIs webView2.
Utilizar o Protocolo CDP (Chrome DevTools Protocol) em aplicações WebView2

Comentários

Esta página foi útil?

Last updated on 2025-06-21

Compartilhar via

Protocolo DevTools do Microsoft Edge

Utilizar o Protocolo DevTools

Pontos finais HTTP do Protocolo DevTools

/json/version

/json/protocol

/json/list

/json/close

Ferramentas Remotas para o Microsoft Edge

/msedge/json/deviceinfo

/msedge/json/list

/msedge/

/msedge/[pid]/json/list

/msedge/[pid]/json/version

/msedge/[pid]/json/protocol/

Protocolo EdgeHTML DevTools

Consulte também

Comentários

Recursos adicionais