PassFront
  1. PassFront
  2. База знаний
  3. Сборка и бандлеры

Что такое source maps и зачем они нужны?

Сборка и бандлеры

Source map связывает минифицированный код в браузере с исходниками, чтобы ошибки и отладка показывали ваши строки.

Ошибка: x is not a function at bundle.js:1:48203
С source map:  Cart.tsx:42  calculateTotal(items)

Проблема

В продакшене код минифицирован: имена сокращены, всё в одной строке. Ошибка «x is not a function в bundle.js:1:48203» ничего не говорит.

Решение

Сборщик создаёт файл .map, где записано соответствие позиций. DevTools и сервисы мониторинга (Sentry) по нему восстанавливают исходные файлы и строки.

Нюансы

  • Публикация карт открывает исходный код всем. Их часто загружают в систему мониторинга при релизе и не отдают публично.
  • Режимы бывают разной подробности — быстрые для разработки и полные для продакшена.
  • Карта должна соответствовать конкретной сборке.

Коротко для собеседования

Source maps превращают минифицированные стектрейсы в читаемые. В продакшене их обычно хранят приватно, например в Sentry.

Подробнее: Chrome DevTools — Source maps

Другие вопросы раздела