Протокол средств разработчика Microsoft Edge

  • Статья

Используйте протокол DevTools для инструментирования, проверки, отладки и профилирования браузеров, включая Microsoft Edge. Протокол Microsoft Edge DevTools соответствует API протокола Chrome DevTools. Справочную документацию см. в статье Средство просмотра протокола Chrome DevTools.

Примечание.

С переходом на базовую веб-платформу Microsoft Edge на Chromium протокол Microsoft Edge (EdgeHTML) DevTools не будет получать никаких дополнительных обновлений. В дальнейшем протокол Microsoft Edge DevTools будет соответствовать API протокола Chrome DevTools.

Все методы, которые были префиксированы ms в microsoft Edge (EdgeHTML) DevTools Protocol , больше не поддерживаются в протоколе Microsoft Edge DevTools.

Использование протокола DevTools

Чтобы подключить клиент настраиваемых инструментов к серверу DevTools в Microsoft Edge, выполните следующие действия.

  1. Закройте все экземпляры Microsoft Edge.

  2. Запустите Microsoft Edge с портом удаленной отладки.

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

  3. При необходимости можно запустить отдельный экземпляр Microsoft Edge с помощью отдельного профиля пользователя.

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

  4. Затем используйте конечную точку HTTP list , чтобы получить список целевых объектов присоединяемой страницы.

    http://localhost:9222/json/list

  5. Наконец, подключитесь к webSocketDebuggerUrl нужному целевому объекту и выполните команды или подпишитесь на сообщения о событиях через сервер веб-сокетов DevTools.

Конечные точки HTTP протокола DevTools

Протокол Microsoft Edge DevTools поддерживает следующие конечные точки HTTP.

/json/version

Предоставляет сведения о браузере хост-компьютера и о том, какую версию протокола DevTools он поддерживает.

Параметры

Нет.

Возвращаемый объект

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

Предоставляет всю область API протокола, сериализованную в виде JSON.

Параметры

Нет.

Возвращаемый объект

Объект JSON, представляющий доступную область API для текущей версии протокола.

/json/list

Предоставляет список потенциальных целевых объектов страниц для отладки.

Параметры

Нет.

Возвращаемый объект

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

Закрывает целевой процесс. Например, в Microsoft Edge закрывает вкладку страницы.

Параметры

Идентификатор целевого объекта

Возвращаемый объект

String("Target is closing")

Средства удаленной работы для Microsoft Edge (бета-версия)

Средства удаленной работы для Microsoft Edge (бета-версия) можно установить из Microsoft Store. Это приложение позволяет удаленно отлаживать Microsoft Edge, работающий на Windows 10 или более позднем устройстве с компьютера разработки.

Сведения о том, как настроить устройство с Windows и подключиться к нему с компьютера разработки, см. в статье Начало работы с удаленной отладкой устройств Windows.

Средства удаленной работы для Microsoft Edge (бета-версия) используют тот же протокол DevTools Microsoft Edge, что и средства разработки, для взаимодействия с Microsoft Edge, запущенным на Windows 10 или более позднем устройстве, которое требуется отладить. Это приложение просто добавляет /msedge/ и идентификатор процесса (pid) перед каждым вызовом протокола. Он поддерживает следующие конечные точки HTTP.

Следующие справочные разделы предназначены для средств удаленной работы для Microsoft Edge.

/msedge/json/deviceinfo

Предоставляет сведения о компьютере с Windows или HoloLens 2 устройстве, подключенном для удаленной отладки.

Параметры

Нет.

Возвращаемый объект

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

/msedge/json/list

Предоставляет список кандидатов всех процессов Microsoft Edge и WebView2 Runtime, выполняемых на подключенном устройстве (включая PWA), а также всех вкладок или целевых объектов в каждом процессе, доступном для отладки.

Параметры

Нет.

Возвращаемый объект

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

Функционально эквивалентно /msedge/json/list.

/msedge/[pid]/json/list

Предоставляет список потенциальных целевых объектов страниц для экземпляра Microsoft Edge, который соответствует указанному [pid] для отладки.

Параметры

Нет.

Возвращаемый объект

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

Предоставляет сведения об экземпляре Microsoft Edge, соответствующем предоставленному [pid] , и о версии протокола DevTools, который он поддерживает.

Параметры

Нет.

Возвращаемый объект

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

Предоставляет всю область API протокола, сериализованную в виде JSON для экземпляра Microsoft Edge, соответствующего предоставленному [pid].

Параметры

Нет.

Возвращаемый объект

Объект JSON, представляющий доступную область API для версии протокола, которую использует экземпляр Microsoft Edge, соответствующий предоставленному [pid] .

См. также