← Browser Run / browser-run / cdp

Správa relací (HTTP)

K správě relací prohlížeče a karet bez použití WebSocket připojení použijte HTTP API. To se hodí pro operace v rámci životního cyklu relace, jako je vytváření relací, výpis karet a úklid prostředků.

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

Referenční dokumentace API dokumentuje všechny endpointy pro správu relací pod /devtools.

Krok 1: Získání relace prohlížeče

Vytvořte novou relaci prohlížeče pomocí POST /devtools/browser endpoint. Relace zůstane aktivní po zadanou dobu keep-alive (v tomto příkladu 10 minut).

curl "https://api.cloudflare.com/client/v4/accounts/ACCOUNT_ID/browser-rendering/devtools/browser?keep_alive=600000" \
	--request POST \
	--header "Authorization: Bearer {api_token}"

{
	"sessionId": "1909cef7-23e8-4394-bc31-27404bf4348f",
	"webSocketDebuggerUrl": "wss://api.cloudflare.com/client/v4/accounts/{account_id}/browser-rendering/devtools/browser/1909cef7-23e8-4394-bc31-27404bf4348f"
}

Uložte sessionId z odpovědi. Použijete ji v dalších požadavcích.

Krok 2: Vytvoření karty s konkrétní adresou URL

Otevřete novou kartu v relaci prohlížeče a přejděte na konkrétní URL adresu pomocí PUT /devtools/browser/{session_id}/json/new koncový bod.

curl "https://api.cloudflare.com/client/v4/accounts/ACCOUNT_ID/browser-rendering/devtools/browser/SESSION_ID/json/new?url=https%3A%2F%2Fexample.com" \
	--request PUT \
	--header "Authorization: Bearer {api_token}"

{
	"id": "8E598E996530FB09E46A22B8B7754F7F",
	"type": "page",
	"url": "https://example.com",
	"title": "Example Domain",
	"description": "",
	"devtoolsFrontendUrl": "https://live.browser.run/ui/view?wss=live.browser.run/api/devtools/browser/1909cef7-23e8-4394-bc31-27404bf4348f/page/8E598E996530FB09E46A22B8B7754F7F?jwt=...",
	"webSocketDebuggerUrl": "wss://live.browser.run/api/devtools/browser/1909cef7-23e8-4394-bc31-27404bf4348f/page/8E598E996530FB09E46A22B8B7754F7F?jwt=..."
}

Krok 3: Výpis všech cílů

Vypište všechny cíle (karty) ve své relaci, abyste ověřili, že karta byla vytvořena, a získali devtoolsFrontendUrl.

curl "https://api.cloudflare.com/client/v4/accounts/ACCOUNT_ID/browser-rendering/devtools/browser/SESSION_ID/json/list" \
	--request GET \
	--header "Authorization: Bearer {api_token}"

[
	{
		"id": "8E598E996530FB09E46A22B8B7754F7F",
		"type": "page",
		"url": "https://example.com",
		"title": "Example Domain",
		"description": "",
		"devtoolsFrontendUrl": "https://live.browser.run/ui/view?wss=live.browser.run/api/devtools/browser/1909cef7-23e8-4394-bc31-27404bf4348f/page/8E598E996530FB09E46A22B8B7754F7F?jwt=...",
		"webSocketDebuggerUrl": "wss://live.browser.run/api/devtools/browser/1909cef7-23e8-4394-bc31-27404bf4348f/page/8E598E996530FB09E46A22B8B7754F7F?jwt=..."
	}
]

Krok 4: Otevření uživatelského rozhraní DevTools

Zkopírujte devtoolsFrontendUrl z odpovědi a otevřete ji v Chromu. Tato adresa URL poskytuje přímý přístup k uživatelskému rozhraní Chrome DevTools připojenému k vaší vzdálené relaci prohlížeče.

Po otevření se načte uživatelské rozhraní DevTools a můžete:

Prozkoumejte DOM a CSS
Ladění JavaScriptu pomocí breakpointů
Sledování síťových požadavků
Zobrazení zpráv konzole
Spuštění JavaScriptu v konzoli
Přejít na různé URL adresy

Krok 5: Úklid

Až budete hotovi, ukončete relaci prohlížeče, abyste uvolnili prostředky.

curl "https://api.cloudflare.com/client/v4/accounts/ACCOUNT_ID/browser-rendering/devtools/browser/SESSION_ID" \
	--request DELETE \
	--header "Authorization: Bearer {api_token}"

{
	"status": "closing"
}

Řešení potíží

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.