← Browser Run / browser-run

Chrome DevTools Protocol (CDP)

/devtools endpointy poskytují možnosti správy relací, které se řídí Chrome DevTools Protocol (CDP) ↗. Tyto koncové body umožňují vytvářet trvalé relace prohlížeče, spravovat více karet a ovládat prohlížeče pomocí příkazů CDP. Hodí se pro pokročilou automatizaci, ladění a vzdálenou správu prohlížeče.

Ke koncovým bodům CDP lze přistupovat z jakéhokoli prostředí, které podporuje připojení WebSocket, včetně lokálních vývojářských strojů, externích serverů a pipeline CI/CD. Díky tomu se k Browser Run můžete připojit ze skriptů Node.js, z Puppeteer, Playwright nebo jakéhokoli klienta kompatibilního s CDP.

Než začnete, vytvoření vlastního API Tokenu hodnotou Browser Rendering - Edit oprávnění.

Chrome DevTools Protocol (CDP) je protokol pro vzdálené ladění, který umožňuje prohlížeče založené na Chromiu instrumentovat, zkoumat, ladit a profilovat. Jde o stejný protokol, jaký k ovládání a sledování prohlížeče používá samotný Chrome DevTools. Oblíbené knihovny pro automatizaci prohlížeče, jako je Puppeteer nebo Playwright, nabízejí nad Chrome DevTools Protocol vysokoúrovňová rozhraní API, díky nimž je automatizace běžných úloh jednodušší.

Endpointy pro relace prohlížeče vám umožňují:

• Vytvářejte a spravujte trvalé relace prohlížeče : Spouštějte instance prohlížeče, které zůstávají aktivní po delší dobu
• Otevírejte, zavírejte a vypisujte karty prohlížeče (targets) : Spravujte více ladicích cílů (stránky, iframy atd.) v rámci jedné instance prohlížeče
• Připojte se přes WebSocket a odesílejte příkazy CDP : Automatizujte akce prohlížeče programově
• Zobrazení živých relací prohlížeče pomocí uživatelského rozhraní Chrome DevTools : Vizuálně ladit a prohlížet vzdálené relace prohlížeče
• Integrujte se stávajícími klienty CDP : Použijte standardní klienty CDP, jako je Puppeteer, nebo vlastní implementace WebSocket

Jakmile získáte relaci prohlížeče, můžete s ní pracovat dvěma způsoby:

Připojte se ke koncovému bodu WebSocket /devtools/browser k získání relace a odeslání Příkazy CDP ↗ přímo přes připojení. Toto je standardní způsob použití CDP a funguje s jakýmkoli klientem CDP, včetně Puppeteer, Playwright, a Klienti MCP.

Pro správu životního cyklu prohlížeče jsou k dispozici také koncové body HTTP, a to bez nutnosti používat WebSockets. Ty se řídí standardem HTTP koncové body CDP ↗:

1. Vytvořit relaci, POST /devtools/browser
2. Vypište karty, GET /devtools/browser/{session_id}/json/list
3. Vytvořit kartu, PUT /devtools/browser/{session_id}/json/new
4. Zavřít kartu, DELETE /devtools/browser/{session_id}/json/close/{target_id}
5. Zavřít relaci, DELETE /devtools/browser/{session_id}

Zkontrolujte Referenční dokumentace API pro úplný seznam koncových bodů.

Pokud máte dotazy nebo narazíte na chybu, podívejte se na Časté dotazy a průvodce řešením problémů Browser Run.