
Вы открываете консоль, и ещё ничего вашего не выполнилось, как появляются четыре красные строки об исходных картах, которые не удалось загрузить. Инстинкт подсказывает пойти и проверить конфигурацию сборки, потому что упоминаемые в ошибке вещи именно её производят.
Это обычно неправильное направление, и причину стоит узнать, потому что требуется всего около десяти секунд, чтобы понять, чья это проблема, но большинство никогда не узнают этот трюк.
Что именно запрашивается
Минифицированный файл может содержать указатель на карту, которая переводит его обратно в исходный код, из которого он был собран. Есть два способа прикрепить карту.
Распространённый способ: комментарий в конце файла, //# sourceMappingURL=bundle.js.map. Другой
способ: HTTP-заголовок, и MDN четко определяет приоритет. Заголовок SourceMap “имеет приоритет
над аннотацией в исходном коде (sourceMappingURL=path-to-map-js.map), и если оба присутствуют,
для разрешения исходной карты используется URL из заголовка”. Есть также более старый заголовок
X-SourceMap, который считается устаревшим.
Назначение карты одинаково чётко определено. По словам MDN: “Инструменты разработчика используют исходную карту для восстановления оригинального исходного кода из оптимизированного JavaScript, возвращённого в ответе, позволяя разработчикам отлаживать оригинальный код, а не его оптимизированный для отправки формат.”
Кто делает запрос: это первый полезный факт
Документация самого Chrome ответит на это одним предложением: “Когда вы открываете DevTools, он пытается загрузить исходные карты, если они есть.”
Итак, запрос делают ваши инструменты разработчика на вашем компьютере, потому что вы их открыли. Посетитель с закрытой консолью не загружает эти файлы и не видит эти строки. Чтобы бы это ни стоило, посетителям это ничего не стоит.
Это уже исключает большую часть паники. Страница не сломана из-за этого, ничего не медленнее для никого, и никакое пользовательское поведение от этого не зависит.
Почему это обычно не ваше
Здесь начинается часть, которая спасает день.
Указатель находится внутри файла, который был отправлен. Если этот файл вышел из вашей собственной
сборки, указатель ваш и пропущенная карта ваша. Но большую часть этих строк создаёт код, который
вы не писали: пакет, опубликованный в npm с оставленным в нём комментарием sourceMappingURL и
без файла .map, потому что издатель исключил его из пакета, чтобы скачивание было меньше.
Ваш бандлер скопировал этот комментарий верно, потому что это комментарий в файле, который его попросили включить. В вашей конфигурации нет ничего, что это произвело, и нет ничего, что это может исправить.
Поэтому прочитайте URL в ошибке, прежде чем что-либо менять. Если путь указывает на ваш собственный
вывод сборки, это ваше. Если он указывает внутрь vendor chunk, путь node_modules или CDN, который вы не
контролируете, это решение издателя в упаковке, и ваши варианты это игнорировать или перестать загружать это.
Три вещи, которые это вызывают
Карта никогда не была опубликована. Самый распространённый случай, и тот, что описан выше. Ничего не нужно исправлять.
Карта существует, но запрос не проходит. Chrome отмечает, что запросы исходных карт “могут рассматриваться как кросс-оригинальные и могут не пройти”, что важный случай для понимания, потому что в консоли это выглядит идентично и вообще не пропущенный файл. Карта с другого оригина без разрешающих заголовков не загружается так же, как та, что никогда не была загружена.
Карта была намеренно не развёрнута. Много команд собирают карты и намеренно держат их вне общей директории, чтобы оригинальный исходный код нельзя было скачать тому, кто откроет инструменты разработчика. Это защитимый выбор, и строка в консоли его цена.
Перестаньте гадать и прочитайте список
Chrome имеет панель, которая отвечает на это для каждого файла вместо того, чтобы вы подходили строкам консоли к бандлам. Developer Resources показывает столбец Status, чтобы увидеть, успешна ли загрузка или не удалась, и столбец Error с сообщением для каждого файла. Это также позволяет вам загрузить карту вручную, что используется, чтобы проверить, что приватная карта в остальном правильна.
Этот список это разница между “консоль полна ошибок исходных карт” и “три из них из одной зависимости и один наш”.
Что делать, по порядку
Если это принадлежит зависимости: ничего. Это шум, сгенерированный вашим инструментарием по упаковке кого-то другого. Никакой пользователь не затронут и никакое изменение сборки его не удалит.
Если это ваше и вы хотите работающие карты, отправьте файл .map рядом с бандлом, или
держите его приватным и загрузите его в ваш трекер ошибок вместо этого, это где он даёт наибольший
результат и разоблачает наименьший. Трассировка стека против минифицированного кода близка к
бесполезности, и это
файл, который это исправляет.
Если вы просто хотите тишины в консоли, параметр находится в DevTools, а не в вашем проекте: Settings, потом Preferences, потом Sources, куда указывает документация Chrome на флажок JavaScript source maps. Отключение его остановит запросы и строки вместе с ними.
Цена, которую никто не считает
Консоль с дюжиной постоянных предупреждений не бесплатна, и цена не производительность.
Это то, что все учатся пропускать. Когда консоль всегда полна красного, красное перестаёт быть сигналом, и единственная строка, которая имеет значение, приходит среди одиннадцати, которые не имеют. Ошибка об неопределённом свойстве, которая объясняет сломанное оформление, сидит четыре строки ниже предупреждения об исходной карте, которое было здесь с марта.
Это более важно, когда это смотрит кто-то другой. Скриншот консоли от пользователя, или захваченный лог, прикреплённый к отчёту об ошибке, приходит со всем этим, и человек, читающий это, должен знать, какие строки постоянная мебель, прежде чем он может увидеть, что ново.
Session Replay
Бесплатное расширение для Chrome. Один клик на странице, которая ведёт себя неправильно, захватывает скриншот, консоль и сетевой лог, и вручает вам ссылку для вставки в тикет.
Знание того, какие из этих строк всегда будут здесь, это большая часть того, что делает захваченную консоль читаемой.
Краткая версия
- Запрос делается вашими инструментами разработчика, когда вы их открываете, не страницей. Никакой посетитель это не видит и ничего не медленнее для них.
- Прочитайте URL в сообщении первым. Путь
node_modulesили vendor означает упаковку зависимости, и в вашей сборке нечего менять. - Карта кросс-оригина не загружается так, как выглядит пропущенная.
- Developer Resources перечисляет статус и ошибку для каждого файла, что лучше, чем читать строки консоли.
- Флажок, который это замалчивает, это предпочтение DevTools, не параметр проекта.
- Реальная цена это консоль, которую никто не читает внимательно больше, включая человека, которому вы её отправили.