INTEGRITY Dokumentace

← Cloudflare Workers / workers / local-development

Local Explorer

Local Explorer je rozhraní v prohlížeči pro zobrazení a úpravu dat ve vašem lokálním vazby a ladění volání Workera během vývoje. Je dostupný na adrese /cdn-cgi/explorer na vašem lokálním vývojovém serveru.

Místo spouštění příkazů CLI nebo psaní jednorázového kódu pro kontrolu lokálního stavu můžete otevřít Local Explorer přímo v prohlížeči a pracovat se svými daty, prohlížet trasování a prohledávat protokoly. Hodí se to, když chcete naplnit testovací data, ověřit, co Worker skutečně zapsal, ladit neúspěšný požadavek nebo spouštět dotazy SQL nad lokální D1 databáze.

Local Explorer funguje s oběma Wrangler a Cloudflare Vite plugin.

Předpoklady

Otevřít Local Explorer

  1. Spusťte lokální vývojovou relaci:

    npx wrangler dev

  2. Otevřete Local Explorer v prohlížeči:

    • Wrangler: stiskněte e ve vašem terminálu.
    • Plugin Vite: přejděte přímo na /cdn-cgi/explorer na trase a portu vašeho vývojového serveru.

Local Explorer je k dispozici ve výchozím nastavení a rozpoznává bindings definované ve vašem Konfigurace Wrangleru automaticky.

Podporované vazby

Local Explorer podporuje následující typy bindings:

Binding Zobrazit Úprava
KV Procházejte klíče, zobrazujte hodnoty a metadata Vytváření, aktualizace a mazání párů klíč-hodnota
R2 Vypsat objekty, zobrazit metadata Nahrávání a mazání objektů
D1 Procházejte tabulky a řádky, spouštějte SQL dotazy Vkládejte, aktualizujte a mazejte řádky pomocí SQL
Durable Objects (úložiště SQLite) Procházejte tabulky a řádky SQLite, spouštějte SQL dotazy Vkládejte, aktualizujte a mazejte řádky pomocí SQL
Workflows Vypsat instance, zobrazit stav a historii kroků Spouštějte nové běhy, opakujte neúspěšné instance

SQL Studio pro D1 a Durable Objects

Pro D1 databáze a Durable Objects které používají Úložné API SQLite, Local Explorer obsahuje SQL Studio. Jde o stejné prostředí, jaké je k dispozici v Cloudflare dashboardu pro nasazené databáze D1. Nabízí jak vizuální prohlížeč tabulek s editací přímo v řádku, tak editor SQL dotazů, ve kterém můžete spouštět libovolné dotazy.

Observabilita

Local Explorer automaticky zaznamenává trasování a protokoly z každého volání Workeru během wrangler dev bez úprav kódu. Získáte stejnou instrumentaci jako v produkci Workers Logs a Trasování, včetně logů volání, operací s bindingy, časování a výstupu konzole, přímo ve vašem prohlížeči během vývoje.

Protokoly

Protokoly zobrazení zachycuje všechny console.* výstup z vašeho Workeru. Filtrujte podle úrovně (error, warn, info, log, debug) nebo vyhledávejte text a najděte konkrétní zprávy.

Trasování

Každé volání Workeru se zobrazí jako trace. Kliknutím na libovolný trace zobrazíte všechny operace vazeb s časováním, stavem a podrobnostmi o chybách.

Trasování také zachycuje operace provedené prostřednictvím vzdálené bindings, takže můžete sledovat volání z lokálně spuštěného Workeru na nasazené prostředky.

Pokud například požadavek provede dvě volání D1 a druhé z nich selže, trace vám přesně ukáže, které volání uspělo a které skončilo chybou, aniž byste museli přidávat console.log() nebo bloky try/catch.

Zobrazení trasování pro POST /api/todos se dvěma rozpětími databáze D1: první INSERT proběhl úspěšně, druhý selhal s chybou "no such table: audit_log"

API

Local Explorer zpřístupňuje API na /cdn-cgi/explorer/api které poskytuje programový přístup ke stejným operacím, jaké jsou dostupné v rozhraní prohlížeče. Toto API poskytuje specifikace OpenAPI ↗ který popisuje všechny dostupné endpointy, parametry a formáty odpovědí.

Chcete-li načíst specifikaci OpenAPI:

curl http://localhost:8787/cdn-cgi/explorer/api

Použití s AI agenty

Když Wrangler nebo plugin Cloudflare Vite zjistí, že běží uvnitř AI agenta, vypíše přímo do terminálu nápovědu s koncovým bodem API Local Exploreru. Agent pak může načíst specifikace OpenAPI ↗ z tohoto endpointu a zjistíte tak všechny dostupné operace, poté provádějte API volání pro čtení nebo úpravu lokálních dat, dotazujte se na trace a logy a ladíte svůj Worker.

Nápověda obsahuje URL adresu API a relevantní endpointy:

This dev session is running in an AI agent.

The Local Explorer API is available at
http://localhost:8787/cdn-cgi/explorer/api

...

Debug with traces:
POST /cdn-cgi/explorer/api/local/observability/query -- query traces and logs with SQL

To může být užitečné jako alternativa k CLI, když chcete, aby agent: