enb-js

enb-js
======


Пакет предоставляет набор ENB-технологий для сборки
JavaScript-кода в проектах, построенных по методологии БЭМ.

Технологии пакета enb-js:

* browser-js
* node-js

Принципы работы технологий и их API описаны в документе API технологий.

Установка

Установите пакет enb-js:

``sh
$ npm install --save-dev enb-js
`

Требования: зависимость от пакета enb версии 0.16.0 или выше.


- Быстрый старт
- Особенности технологий пакета
- Изоморфный JavaScript
- Отладка кода
- Source Maps
- Режим разработки для Node.js
- Изоляция кода исходных блоков
- Минимизация кода
- Лицензия


Быстрый старт
-------------

Чтобы собрать JS-код для исполнения в браузере, подключите технологию browser-js, а для работы в Node.js — node-js.

`js
var BrowserJsTech = require('enb-js/techs/browser-js'),
NodeJsTech = require('enb-js/techs/node-js'),
FileProvideTech = require('enb/techs/file-provider'),
bemTechs = require('enb-bem-techs');

module.exports = function(config) {
config.node('bundle', function(node) {
// Получение списка файлов для сборки
node.addTechs([
[FileProvideTech, { target: '?.bemdecl.js' }],
[bemTechs.levels, { levels: ['blocks'] }],
[bemTechs.deps],
[bemTechs.files]
]);

// Сборка JS-файл для работы в браузере
node.addTech([BrowserJsTech, { / опции технологии / }]);
node.addTarget('?.browser.js');

// Сборка JS-файл для работы в Node.js
node.addTech([NodeJsTech, { / опции технологии / }]);
node.addTarget('?.browser.js');
});
};
`

Особенности технологий пакета
-----------------------------

$3

Термин «изоморфность» означает возможность выполнения одного и того же кода как в браузере, так и в Node.js.

Предполагается, что в файловой системе код блоков разделяется по файлам с разными расширениями, которые обозначают в какой среде может работать данный код:

.vanilla.js — файлы, код которых может работать как в бразуере, так и в Node.js.
.js и *.browser.js — файлы, код которых может работать только в браузере.
.node.js — файлы, код которых может работать только в Node.js.

$3

#### Source Maps

Для удобной отладки кода в браузере следует включить генерацию карт кода с помощью опции sourcemaps.

#### Режим разработки для Node.js

Для сборки файлов, предназначенных для исполнения в Node.js, существует специальный режим, удобный для разработки.

После сборки итоговый файл не содержит исходного кода блоков, а лишь подключает необходимые файлы с помощью require.

`js
require('../blocks/utils/utils.node.js');
require('../blocks/page/page.node.js');
`

При таком подходе сообщения об ошибках будут указывать на код из исходных файлов. Кроме того, при каждом выполнении собранного файла кэш Node.js не будет учитываться. Это позволяет видеть изменения без перезапуска Node.js.

Настроить сборку для выкладки в production можно с помощью опций devMode или bundled.

$3

При обычной сборке JS-кода, предназначенного для работы в браузере, один блок может некорректно влиять на работу другого блока.

`js
/ begin: blocks/greeting/greeting.js /
var message = 'Кукусики!';

onStart(function () {
alert(message);
});
/ end: blocks/greeting/greeting.js /
/ begin: blocks/parting/parting.js /
var message = 'Я буду скучать...';

onEnd(function () {
alert(message);
});
/ end: blocks/parting/parting.js /
``

Чтобы исключить подобное влияние, следует использовать опцию iife, которая обернет код каждого исходного файла с помощью IIFE.

$3

Для минимизации JS-кода используется UglifyJS.

Включить минимизацию можно с помощью опции compress.

Лицензия
--------

© 2014 YANDEX LLC. Код лицензирован Mozilla Public License 2.0.