Я бачив .mapфайли для TypeScript. Я хочу знати, для чого призначені ці файли. Чи містять вони посилання на інші файли, на які посилається файл .ts?
Я бачив .mapфайли для TypeScript. Я хочу знати, для чого призначені ці файли. Чи містять вони посилання на інші файли, на які посилається файл .ts?
Відповіді:
Файли .map - це файли вихідних карт, які дозволяють інструментам перетворювати між випущеним кодом JavaScript та вихідними файлами TypeScript, які його створили. Багато налагоджувачів (наприклад, Visual Studio або інструменти розробника Chrome) можуть споживати ці файли, щоб ви могли налагоджувати файл TypeScript замість файлу JavaScript.
Це той самий формат вихідної карти, який створюється деякими мініфайнерами та іншими мовами, скомпільованими до JS, такими як CoffeeScript .
Початкова карта - це в основному те, що в ній сказано, карта з однієї мови на іншу, тому налагоджувач може запустити код JavaScript, але показати вам рядок, який насправді його створив.
Для практичних цілей налагодження:
Вихідна карта дозволяє вам встановити точку зупинки у файлі TypeScript, а потім налагодити код. Це можна зробити в Chrome та Firefox. Дещо заплутано, поведінка налагоджувача в Chrome полягає в тому, що при досягненні точки зупинки фактично відображається файл '.js' (зупинено в точці зупинки).
На сьогоднішній день налагоджувач Firefox відображатиме фактичний файл TypeScript, коли він ламається. Див. Посилання нижче:
(це також показує, як Visual Studio можна налаштувати на створення вихідної карти)
Щоб зрозуміти, як працює вихідна карта, ви можете прочитати розділ "Анатомія вихідної карти" тут:
https://www.html5rocks.com/en/tutorials/developertools/sourcemaps/
Існує два типи .mapфайлів, які найпоширеніші в Typescript. Один - це Карта джерела ( .js.map), а інший - Карта декларації ( .d.ts.map). Поясню обидва докладно по одному.
.js.mapВихідні .js.mapфайли map ( ) містять визначення відображення, які пов'язують кожен фрагмент згенерованого коду Javascript назад до певного рядка та стовпця відповідного файлу Typescript. Визначення відображення у цих файлах мають формат JSON.
Коли ввімкнено вихідні карти, під час налагодження Visual Studio Code та Chrome DevTools відображатимуть ваш код Typescript замість згенерованого складного коду Javascript.
Навіщо використовувати вихідні карти?
Наприклад, у виробничих додатках ми використовуємо інструменти побудови, такі як Rollup, щоб видалити мертвий код, Prepack для усунення та заміни коду обчисленнями, які можна оцінити під час компіляції, а не часу виконання, а потім зменшити код за допомогою Uglify. І не кажучи вже про складність вже перекладеного коду Javascript. Отже, отриманий код може значно відрізнятися від коду, який ви насправді написали. Тому рекомендується використовувати вихідні карти, це робить налагодження дуже простим, оскільки ви переходите до оригінального вихідного коду.
Інструменти моніторингу процесів, моніторингу помилок, реєстрації та стеку, такі як Sentry, Bugsnag, PM2, Winston, також використовують вихідні карти для зіставлення рядків і стовпців у стеку винятків Javascript, що відстежується до Typescript.
Як користуватися вихідними картами?
Ви можете ввімкнути вихідні карти або за допомогою --sourceMapопції під час компіляції, або вказавши її compilerOptionsу tsconfig.jsonфайлі свого проекту, наприклад:
{
"compilerOptions": {
...
"sourceMap": true,
"outDir": "./out"
}
}
Примітка щодо безпеки для вихідних карт:
Якщо ви хочете досягти певної безпеки шляхом забруднення коду вашого браузера, ви можете виключити вихідні карти з коду браузера у вашому виробничому додатку.
.d.ts.map.d.ts.mapФайли map ( ) декларації, також відомі як вихідні карти декларації, містять визначення відображення, які пов'язують кожну декларацію типу, створену у .d.tsфайлах, із вихідним вихідним файлом ( .ts). Визначення відображення в цих файлах мають формат JSON.
Це корисно при навігації кодом. Ви зможете використовувати такі функції редактора, як "Перейти до визначення" та "Перейменувати", щоб прозоро переходити та редагувати код у підпроектах, коли ви розділили великий проект на невеликий кілька проектів, використовуючи посилання на проекти.
Щоб увімкнути карти декларацій, вкажіть у tsconfig.jsonфайлі свого проекту наступні два параметри :
{
"compilerOptions": {
...
"declaration": true,
"declarationMap": true
}
}
Це воно! Сподіваюся, що це допомагає.
.mapфайли на веб-сайт?