По правилам современного фронтенда отдавать пользователю надо минимум файлов с минимальным весом. Но во время разработки писать все в один файл, ещё и в сжатом виде, очень неудобно, поэтому для решения этой задачи используют разные сборки в виде готовых yeoman.io, generator-yeogurt и т.п. Или собирают сами с использование Grunt, Gulp и т.п. Но речь не об этом, речь об отладке javascript-а в этих сборках.
Возможно, в маленьких проектах в этом нет необходимости, но в крупных без этого никуда, особенно если вы используете MVC фреймворк и/или кучу самописного кода.
На Хабре уже есть хорошая статья на тему отладки js с помощью map файла в хроме — «Введение в Javascript Source Maps». Но если вы работает в среде разработки, особенно если эта среда от JetBrains, то лезть в хром как-то неправильно (хотя, конечно, это очень холиварная тема). Поэтому я решил написать эту статью.
Итак, приступим.
Сначала для отладки в IntelliJ IDEA / PHPStorm / WebStorm понадобится GoogleChrome с плагинам от JetBrains.
![image](https://habrastorage.org/r/w780q1/files/5e1/9f4/226/5e19f4226b7a427f9f5301048b7613bc.jpg)
Далее есть несколько вариантов:
Я делал через UglifyJS и поэтому в примере будет он.
Для этого надо установить npm пакет uglify-js с глобальным ключом.
Далее переходим в File->Settings->Tools->FileWatchers (если FileWatchers у вас не установлен, то установите его через плагины). С права нажмите '+' и в выпадающем меню выбираем UglifyJS:
![image](https://habrastorage.org/r/w780q1/files/cd0/3af/18a/cd03af18ae2b405883846a68d7d16e71.jpg)
Если все окей, то программа сама найдет .cmdUglifyJS, если нет, то придется её прописать вручную.
На винде это будет: C:\Users\UsersName\AppData\Roaming\npm\uglifyjs.cmd.
Потом в 'Arguments:' прописываем необходимые аргументы, включая аргументы для создания map файла , согласно оф.документации.
Теперь ide будет следить за указанными js-файлами и сама создавать map файлы.
Поскольку я пользуюсь gulp, то пример приведу на нём.
Подробно описывать настройки не буду, т.к. на эту тему и так много статей, просто приведу пример кода гальп-файла, который я использую:
В данном примере мы используем gulp-sourcemaps для создания map файла, gulp-concat для конкатенации файлов, gulp-uglify для минификации и gulp-rename для добавления суффикса min.
Жмём на выпадающие меню дебагера и выбираем 'EditConfigurations...'
![image](https://habrastorage.org/r/w780q1/files/e85/b15/1ef/e85b151ef45148c89c6768a2cd757957.jpg)
В появившемся окне, в верхнем левом углу жмем '+' и в появившемся выпадающем списке выбираем JavaScriptDebug.
![image](https://habrastorage.org/r/w780q1/files/87e/5d3/15d/87e5d315dcba4150b22222c12d748933.jpg)
В окне настройки дебагера, в строке Name пишем имя задачи, в URL пишем, или адрес сайта на котором будет дебажить javascript, или локальный каталог/html файл, который будет отрываться в браузере при запуске дебага (я предпочитаю работать с адресом сайта). В выпадающем меню 'Browser:' выбираем браузер, который будет отрываться при запуске дебага.
Если прописать url в поле URL, то появится поле 'RemoteURLsoflocalfiles (optional):', где можно указать корневую папку этого url и виртуальный адрес дебагjs файлов. (т.к. напротив файлов будет написано ваш_сайт.ру/map/file.js)
![image](https://habrastorage.org/r/w780q1/files/e80/26b/aae/e8026baae639407a84cc02703179b491.jpg)
Это мой пример. У вас будет вместо .jsx просто.js.
Теперь, когда у нас все готово, жмем на жучка:
![image](https://habrastorage.org/r/w780q1/files/a07/d56/7c6/a07d567c63894b64a819c35fa6a56563.jpg)
Если все окей, то откроется браузер по заданному адресу с всплывающем окном «JetBrains IDE Support отлаживает эту вкладку» (во время отладки не закрывайте это окно, т.к. сразу же оборвётся связь с ide). В открывшемся окне дебага, во вкладке Scripts, можно будет увидеть свои js файлы, в которых надо ставить брекпоинты (скорее всего, у них будет адрес: ваш_сайт.ру/map/file.js, но может быть и по-другому, потому что адрес, где виртуально будут созданы исходные js файлы, зависит от заданных настроек программе, которая создает map файл для дебага). Если ide не видит брекпоинты (красный кружочек без галочки), то в дебаг режиме, во вкладке Scripts, щёлкните по этому файлу правой клавишей мыши и в меню выберите SpecifyLocalPath.
![image](https://habrastorage.org/r/w780q1/files/328/924/82a/32892482a9a442029510d8e96f5aa59a.jpg)
Если все окей, то брейкпоинт будет с галочкой.
Таким образом, мы получаем всю мощь отладки javascripta в ide «не отходя от кассы».
К дополнительному прочтению рекомендую:
— Как уже упоминалось, хорошая статья на Хабре об отладке js в хроме;
— Официальная документация JetBrains к поддерживаемым минификатором javascript;
— Если кто не знает, что такое Gulp, прочитать о нём можно здесь;
— Для тех, кто не знает, что такое npm, есть ссылка.
Возможно, в маленьких проектах в этом нет необходимости, но в крупных без этого никуда, особенно если вы используете MVC фреймворк и/или кучу самописного кода.
На Хабре уже есть хорошая статья на тему отладки js с помощью map файла в хроме — «Введение в Javascript Source Maps». Но если вы работает в среде разработки, особенно если эта среда от JetBrains, то лезть в хром как-то неправильно (хотя, конечно, это очень холиварная тема). Поэтому я решил написать эту статью.
Итак, приступим.
Сначала для отладки в IntelliJ IDEA / PHPStorm / WebStorm понадобится GoogleChrome с плагинам от JetBrains.
![image](https://habrastorage.org/files/5e1/9f4/226/5e19f4226b7a427f9f5301048b7613bc.jpg)
Далее есть несколько вариантов:
Первый вариант — через ide и UglifyJS/YUI Compressor/ClosureCompiler
Я делал через UglifyJS и поэтому в примере будет он.
Для этого надо установить npm пакет uglify-js с глобальным ключом.
npm install uglify-js -g
Далее переходим в File->Settings->Tools->FileWatchers (если FileWatchers у вас не установлен, то установите его через плагины). С права нажмите '+' и в выпадающем меню выбираем UglifyJS:
![image](https://habrastorage.org/files/cd0/3af/18a/cd03af18ae2b405883846a68d7d16e71.jpg)
Если все окей, то программа сама найдет .cmdUglifyJS, если нет, то придется её прописать вручную.
На винде это будет: C:\Users\UsersName\AppData\Roaming\npm\uglifyjs.cmd.
Потом в 'Arguments:' прописываем необходимые аргументы, включая аргументы для создания map файла , согласно оф.документации.
Теперь ide будет следить за указанными js-файлами и сама создавать map файлы.
Второй вариант — через gulp, grunt, browserify и т.д.
Поскольку я пользуюсь gulp, то пример приведу на нём.
Подробно описывать настройки не буду, т.к. на эту тему и так много статей, просто приведу пример кода гальп-файла, который я использую:
var gulp = require('gulp');
var sourcemaps = require('gulp-sourcemaps');
var uglify = require('gulp-uglify');
var rename = require('gulp-rename');
var concat = require('gulp-concat');
gulp.task('react', function(){
return gulp.src('www/js/*.js')
.pipe(sourcemaps.init())
.pipe(concat('main.js'))
.pipe(uglify())
.pipe(rename({
suffix: ".min"
}))
.pipe(sourcemaps.write('../maps'))
.pipe(gulp.dest('www/js/main/'));
});
В данном примере мы используем gulp-sourcemaps для создания map файла, gulp-concat для конкатенации файлов, gulp-uglify для минификации и gulp-rename для добавления суффикса min.
После того, как вы определись с вариантом создания map файла для проекта, переходим к настройки дебагера в IDE
Жмём на выпадающие меню дебагера и выбираем 'EditConfigurations...'
![image](https://habrastorage.org/files/e85/b15/1ef/e85b151ef45148c89c6768a2cd757957.jpg)
В появившемся окне, в верхнем левом углу жмем '+' и в появившемся выпадающем списке выбираем JavaScriptDebug.
![image](https://habrastorage.org/files/87e/5d3/15d/87e5d315dcba4150b22222c12d748933.jpg)
В окне настройки дебагера, в строке Name пишем имя задачи, в URL пишем, или адрес сайта на котором будет дебажить javascript, или локальный каталог/html файл, который будет отрываться в браузере при запуске дебага (я предпочитаю работать с адресом сайта). В выпадающем меню 'Browser:' выбираем браузер, который будет отрываться при запуске дебага.
Если прописать url в поле URL, то появится поле 'RemoteURLsoflocalfiles (optional):', где можно указать корневую папку этого url и виртуальный адрес дебагjs файлов. (т.к. напротив файлов будет написано ваш_сайт.ру/map/file.js)
![image](https://habrastorage.org/files/e80/26b/aae/e8026baae639407a84cc02703179b491.jpg)
Это мой пример. У вас будет вместо .jsx просто.js.
Теперь, когда у нас все готово, жмем на жучка:
![image](https://habrastorage.org/files/a07/d56/7c6/a07d567c63894b64a819c35fa6a56563.jpg)
Если все окей, то откроется браузер по заданному адресу с всплывающем окном «JetBrains IDE Support отлаживает эту вкладку» (во время отладки не закрывайте это окно, т.к. сразу же оборвётся связь с ide). В открывшемся окне дебага, во вкладке Scripts, можно будет увидеть свои js файлы, в которых надо ставить брекпоинты (скорее всего, у них будет адрес: ваш_сайт.ру/map/file.js, но может быть и по-другому, потому что адрес, где виртуально будут созданы исходные js файлы, зависит от заданных настроек программе, которая создает map файл для дебага). Если ide не видит брекпоинты (красный кружочек без галочки), то в дебаг режиме, во вкладке Scripts, щёлкните по этому файлу правой клавишей мыши и в меню выберите SpecifyLocalPath.
![image](https://habrastorage.org/files/328/924/82a/32892482a9a442029510d8e96f5aa59a.jpg)
Если все окей, то брейкпоинт будет с галочкой.
Таким образом, мы получаем всю мощь отладки javascripta в ide «не отходя от кассы».
К дополнительному прочтению рекомендую:
— Как уже упоминалось, хорошая статья на Хабре об отладке js в хроме;
— Официальная документация JetBrains к поддерживаемым минификатором javascript;
— Если кто не знает, что такое Gulp, прочитать о нём можно здесь;
— Для тех, кто не знает, что такое npm, есть ссылка.