INTEGRITY Документация

← Cloudflare Workers / workers / local-development

Local Explorer

Local Explorer представляет собой браузерный интерфейс для просмотра и редактирования данных в вашем локальном привязки и отладки вызовов Worker в процессе разработки. Она доступна по адресу /cdn-cgi/explorer на вашем локальном сервере разработки.

Вместо того чтобы выполнять команды CLI или писать одноразовый код для проверки локального состояния, можно открыть Local Explorer в браузере и работать с данными, просматривать трассировки и искать записи в логах. Это удобно, когда нужно заполнить тестовые данные, проверить, что записал Worker, отладить неудачный запрос или выполнить SQL-запросы к локальной D1 базу данных.

Local Explorer работает как с Wrangler и Cloudflare Vite plugin.

Предварительные требования

Открыть Local Explorer

  1. Запустите локальную сессию разработки:

    npx wrangler dev

  2. Откройте Local Explorer в браузере:

    • Wrangler: нажмите e в вашем терминале.
    • Плагин Vite: перейдите напрямую к /cdn-cgi/explorer для маршрута и порта вашего dev сервера.

Local Explorer доступен по умолчанию и определяет привязки, заданные в вашем Конфигурация Wrangler автоматически.

Поддерживаемые привязки

Local Explorer поддерживает следующие типы привязок:

Привязка Просмотр Изменить
KV Просматривайте ключи, значения и метаданные Создание, обновление и удаление пар «ключ-значение»
R2 Список объектов, просмотр метаданных Загружайте и удаляйте объекты
D1 Просматривайте таблицы и строки, выполняйте SQL-запросы Вставка, обновление и удаление строк через SQL
Durable Objects (хранилище SQLite) Просматривайте таблицы и строки SQLite, выполняйте SQL-запросы Вставка, обновление и удаление строк через SQL
Workflows Список экземпляров, просмотр статуса и истории шагов Создание новых запусков, повтор неудачных экземпляров

SQL Studio для D1 и Durable Objects

Для D1 базы данных и Durable Objects которые используют API хранилища SQLite, Local Explorer включает SQL Studio. Это тот же интерфейс, что доступен в панели управления Cloudflare для развёрнутых баз данных D1. Он предоставляет как визуальный просмотрщик таблиц с редактированием на месте, так и редактор SQL-запросов, в котором можно выполнять произвольные запросы.

Observability

Local Explorer автоматически захватывает трассировки и логи каждого вызова Worker во время wrangler dev без изменения кода. Вы получаете тот же набор инструментов наблюдаемости, что и в продакшене Workers Logs и Трассировки, включая логи вызовов, операции с биндингами, время выполнения и вывод консоли, прямо в браузере во время разработки.

Журналы

Журналы фиксирует все console.* вывод вашего Worker. Фильтруйте по уровню (error, warn, info, log, debug) или ищите по тексту, чтобы найти нужные сообщения.

Трассировки

Каждый вызов Worker отображается как трассировка. Выберите любую трассировку, чтобы увидеть все операции с привязками вместе с временем выполнения, статусом и подробностями об ошибках.

Трассировка также фиксирует операции, выполненные через удаленные привязки, поэтому вы можете просматривать вызовы от локально запущенного Worker к развёрнутым ресурсам.

Например, если запрос делает два вызова D1 и второй завершается ошибкой, трассировка точно показывает, какой вызов выполнился успешно, а какой завершился ошибкой, без добавления console.log() или блоки try/catch.

Представление трассировки для POST /api/todos с двумя спанами базы данных D1: первый INSERT выполнен успешно, второй завершился ошибкой "no such table: audit_log"

API

Local Explorer предоставляет API по адресу /cdn-cgi/explorer/api который предоставляет программный доступ к тем же операциям, что доступны в браузерном интерфейсе. Этот API отдаёт Спецификация OpenAPI ↗ который описывает все доступные конечные точки, параметры и форматы ответов.

Чтобы получить спецификацию OpenAPI:

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

Используйте с ИИ-агентами

Когда Wrangler или плагин Cloudflare для Vite обнаруживает, что работает внутри ИИ-агента, он выводит в терминал подсказку с эндпоинтом Local Explorer API. Агент может получить Спецификация OpenAPI ↗ из этого эндпоинта, чтобы узнать обо всех доступных операциях, а затем выполнять вызовы API для чтения или изменения локальных данных, запроса трассировок и логов, а также отладки вашего Worker.

Подсказка включает URL API и соответствующие эндпоинты:

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

Это может быть полезной альтернативой CLI, если вы хотите, чтобы агент: