spec__utils

docs/tests.ru.md

@@ -38,6 +38,8 @@
 
 Для моков используется библиотека [sinon](http://sinonjs.org/).
 
+Для помощи в написании тестов существует модуль [spec__utils](utils.ru.md)
+
 ### Варианты оформления тестов
 
 Условно можно выделить два случая:

docs/utils.ru.md

@@ -0,0 +1,37 @@
+Утилиты для написания тестов
+============================
+
+Проект `bem-pr` содержит набор утилит для упрощенного написания тестов клиентского кода BEM-блоков, эти утилиты доступны в модуле `spec__utils`.
+Пример теста, использующего утилиты:
+
+```js
+modules.define('spec', ['spec__utils'], function(provide, utils) {
+
+    describe('test-block', function() {
+
+        var bemjson = {
+            block : 'test-block',
+            mods : { someMod : 'someVal' }
+        };
+
+        it('should init successfully', function() {
+            var block = utils.buildBlock('test-block', bemjson);
+
+            block.getMod('someMod').should.equal('someVal');
+
+            utils.destruct(block); // Настоятельно рекомендуем очищать блок после теста
+        });
+
+    });
+});
+```
+
+## Доступные функции
+
+### buildBlock(name, bemjson)
+
+Инициализирует и возвращает BEM-блок `name` на основе переданного `bemjson`.
+
+### destruct(block)
+
+Удаляет блок и DOM-дерева. Рекомендуется вызывать эту функцию после каждого теста для всех созданных блоков.

spec.blocks/spec/__utils/spec__utils.deps.js

@@ -0,0 +1,7 @@
+[{
+    mustDeps: [
+        { block : 'i-bem', elem : 'dom' },
+        { block : 'BEMHTML' },
+        { block : 'jquery' }
+    ]
+}]

spec.blocks/spec/__utils/spec__utils.js

@@ -0,0 +1,31 @@
+/**
+ * @module spec__utils
+ */
+modules.define('spec__utils', ['i-bem__dom', 'BEMHTML', 'jquery'], function(provide, BEMDOM, BEMHTML, $) {
+
+provide({
+    /**
+     * Builds a block by name and bemjson
+     *
+     * @function buildBlock
+     * @param {string} name
+     * @param {object} bemjson
+     * @return {object} bem block
+     */
+    buildBlock : function(name, bemjson) {
+        bemjson = bemjson || { block : name };
+        return BEMDOM.init($(BEMHTML.apply(bemjson)).appendTo('body')).bem(name);
+    },
+
+    /**
+     * Clean up block
+     *
+     * @function destruct
+     * @param {object} block bem block
+     */
+    destruct : function(block) {
+        BEMDOM.destruct(block.domElem);
+    }
+});
+
+});

spec.blocks/spec/spec.deps.js

@@ -16,6 +16,7 @@
         'sinon',
         'sinon-chai',
         'simulate-dom-event',
-        'jquery'
+        'jquery',
+        { elem : 'utils' }
     ]
 }]