При отладке веб-приложений ошибки в минифицированном файле bundle.min.js:1:27698 автоматически преобразуются в строки исходного кода, например, src/index.ts:73:16. За этот процесс отвечают карты источников (Source Maps) — файлы с расширением .map.
Когда браузерные инструменты DevTools обнаруживают в конце JS-файла специальный комментарий с указанием пути к карте:
//# sourceMappingURL=bundle.min.js.map
они фоново загружают этот JSON-документ. Он содержит поля sources (пути к исходным файлам), names (список оригинальных имен символов) и mappings.
Поле mappings содержит закодированные строки соответствия позиций. Чтобы минимизировать размер файла, разработчики спецификации TC39 применили формат Base64 VLQ (Variable-Length Quantity) и дельта-кодирование (хранение смещений координат относительно предыдущего сегмента вместо абсолютных значений строк и столбцов). Загадочные цепочки символов вида AAAA,OAAO,SAAS декодируются браузером в числовые кортежи, определяющие точное смещение символов. Это позволяет DevTools восстанавливать исходный TypeScript-код без загрузки тяжелых несжатых файлов на стороне клиента.
