Поделиться через

Протокол средств разработчика 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] .

См. также