DevToolsPlugin

Zveřejňuje zprávy dev proxy serveru a informace o zachycených požadavcích a odpovědích v prohlížeči Chrome DevTools. Podporuje jak požadavky HTTP, tak komunikaci STDIO.

snímek obrazovky Microsoft Edge s vývojářovými nástroji zobrazujícími zprávy dev proxy serveru

snímek obrazovky Microsoft Edge s vývojářovými nástroji zobrazující požadavky a odpovědi zachycené dev proxy serverem

Příklad konfigurace

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "DevToolsPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "devTools"
    }
  ],
  "devTools": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/devtoolsplugin.schema.json",
    "preferredBrowser": "Edge"
  }
}

Vlastnosti konfigurace

Vlastnost Popis Výchozí
preferredBrowser Který prohlížeč se má použít ke spuštění Dev Tools. Podporované hodnoty: Edge, EdgeDev, Chrome Edge
port Port, na kterém modul plug-in naslouchá připojení DevTools. 0 vybere náhodný dostupný port. Pevný port použijte, když ho potřebujete publikovat, například při spuštění dev Proxy v kontejneru. 0
launchBrowser Určuje, jestli se má prohlížeč spouštět pomocí Dev Tools. Pokud falsemodul plug-in nespustí prohlížeč a místo toho zaznamená adresu URL dev Tools, kterou otevřete v Microsoft Edge nebo Google Chrome sami. true

Možnosti příkazového řádku

Žádný

Remarks

Modul plug-in naslouchá připojení Dev Tools na IP adrese, kterou používá dev proxy server, který jste nastavili pomocí této --ip-address možnosti. Když ho nastavíte na 0.0.0.0 hodnotu nebo ::, modul plug-in naslouchá na všech rozhraních a adresa URL dev Tools odkazuje na 127.0.0.1. Na Windows naslouchání na všech rozhraních vyžaduje práva správce nebo seznam ACL adresy URL. Pokud modul plug-in nemůže naslouchat na všech rozhraních, naslouchá místo 127.0.0.1 toho, takže se můžete připojit jenom ke službě Dev Tools ze stejného počítače.

Pokud chcete chránit zachycený provoz, modul plug-in přijímá pouze připojení Dev Tools, která:

  • použijte adresu URL, kterou dev Proxy spouští nebo protokoluje. Adresa URL obsahuje náhodný token, který dev proxy generuje při každém spuštění.
  • pochází z front-endu DevTools pro Chrome, a to buď devtools://devtools, http://localhost:9222nebo http://127.0.0.1:9222.

Modul plug-in odmítne další připojení 403 Forbidden a zaznamená upozornění.

Pokud chcete použít modul plug-in při spuštění Dev Proxy v kontejneru, vývojovém kontejneru nebo GitHub Codespaces, nastavte na pevný port, nastavte portlaunchBrowser na falsea publikujte nebo přesměrovávejte port do počítače. Další informace najdete v tématu Kontrola požadavků při spuštění dev proxy v kontejneru.

Známé problémy

Dev Tools se neotevře v Microsoft Edgi ve Windows

Používáte Dev Proxy ve Windows a nakonfigurujete ho tak, aby používal Microsoft Edge k zobrazení Dev Tools. Po spuštění Dev Proxy se spustí inspektor, ale Dev Tools se neotevře nebo otevřou prázdné.

Tento problém vyřešíte takto:

  1. Otevřít Microsoft Edge
  2. Přejděte na Nastavení
  3. Otevření systémových a výkonových
  4. Zakázání zvýšení po spuštění
  5. Zavření všech oken a procesů Microsoft Edge
  6. Spuštění dev proxy serveru

Podpora STDIO

Při použití DevToolsPlugin s příkazemstdio můžete zkontrolovat komunikaci STDIN/STDOUT/STDERR v Chrome DevTools:

  • Zprávy se zobrazují s adresami stdio://command-name URL
  • Žádosti se zobrazují jako STDIN metoda
  • Odpovědi se zobrazují jako STDOUT (stav 200) nebo STDERR (500)
  • Texty zpráv se formátují jako JSON, pokud je to možné.
  • Informace o časování jsou k dispozici pro jednotlivé páry požadavků a odpovědí.

Příklad konfigurace pro STDIO

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "DevToolsPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "devTools"
    }
  ],
  "devTools": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/devtoolsplugin.schema.json",
    "preferredBrowser": "Edge"
  }
}

Pak spusťte tyto příkazy:

devproxy stdio npx -y @modelcontextprotocol/server-filesystem

Další krok