← Cloudflare Pages / pages / functions

Source maps и трассировки стека

Трассировки стека ↗ помогают отлаживать код, если в приложении возникает необработанное исключение. Трассировки стека показывают, какие именно функции были вызваны, в каком порядке, из какой строки и файла и с какими аргументами.

Большая часть JavaScript-кода сначала собирается в бандл, часто транспилируется, а затем минифицируется перед деплоем в продакшен. Этот процесс создает бандлы меньшего размера для оптимизации производительности и при необходимости преобразует код из TypeScript в Javascript.

Source maps сопоставляют скомпилированный и минифицированный код с исходным кодом, который вы написали. Source maps объединяются с трассировкой стека, возвращаемой средой выполнения JavaScript, чтобы показать вам понятную трассировку стека.

Чтобы включить source maps, укажите --upload-source-maps флаг для wrangler pages deploy или добавьте следующее в конфигурационный файл Wrangler если вы используете среду сборки Pages:

{
	"upload_source_maps": true
}

upload_source_maps = true

Если включена загрузка карт исходного кода, Wrangler автоматически создаёт и загружает файлы карт исходного кода при запуске wrangler pages deploy.

Когда в вашем приложении возникает необработанное исключение, мы получаем карту исходного кода (source map) и с ее помощью сопоставляем трассировку стека этого исключения со строками исходного кода вашего приложения.

Затем можно просмотреть трассировку стека при потоковой передаче логи в реальном времени.

• Логи в реальном времени - Узнайте, как в реальном времени просматривать журналы Pages.