Тестирование модулей RequireJS в Symfony2
На современном этапе тестирование занимает очень важное положение в программировании любых продуктов. Веб программирование на яваскрипт не является исключением. В этой статье коснемся такого часного случая, как тестирование модулей RequireJS в связке с Symfony2.Данная статья является логическим продолжением предыдущей, по-этому чтение рекомендую начинать с первой статьи в этой серии «Оптимизация модулей RequireJS в Symfony2», чтобы четче понимать то, что здесь происходит.
Итак, чтобы иметь возможность тестировать те модули, которые мы создаем на яваскрипте с помощью RequireJS, воспользуемся такой распространенной библиотекой для тестирования яваскриптов, как Qunit. Для этого, как пишут на оффсайте необходимо создать небольшую html страницу, на которой будут отображаться проводимые тесты. Поскольку мы имеем дело с Symfony2, нам потребуется сделать простейший контроллер, прописать к нему роут и подцепить вьюшку. В зависимости от конкретного случая, это можно с делать в отдельном бандле, или в каком-либо из уже имеющихся. Чтобы не нагромождать статью лишним кодом, предположим, что существует WebBundle в котором мы это и сделаем.
Контроллер будет выглядеть очень просто:
#src/Acme/WebBundle/Controller/TestController.php render ('AcmeWebBundle: Test: layout.html.twig'); } } ?> Создадим элементарную вьюшку для отображения результаов тестов, как рекомендуют в документации: #src/Acme/WebBundle/Resources/views/Test/layout.html.twig
#src/Acme/WebBundle/Resources/assets/js/test.js (function () {
«use strict»;
// Отключаем автозагрузку в конфиге Qunit, чтобы не было ошибок, типа // «Called start () while already started (QUnit.config.semaphore was 0 already)» QUnit.config.autoload = false; QUnit.config.autostart = false;
//require the unit tests. require ( [«QUnit», «tests/user/user», «tests/user/user2»], function (QUnit, user) { // Запускаем тесты user.run (); user2.run ();
// Стартуем QUnit. QUnit.load (); QUnit.start (); } ); }()); Для того, чтобы это запустилось необходимо доработать конфигурацию HearsayRequireJSBundle, оговоренную в предыдущей статье, она примет вид (изменения выделены): # app/config/config.yml hearsay_require_js: require_js_src: //cdnjs.cloudflare.com/ajax/libs/require.js/2.1.14/require.min.js initialize_template: HearsayRequireJSBundle: initialize.html.twig #папка в которую будут собираться наши, не полностью обработанные, скрипты в «дев» версии в каталоге «web». base_url: js #путь к папке со скриптами в бандле base_dir: %kernel.root_dir%/…/src/Acme/DemoBundle/Resources/assets/js # Required #пути к основным модулям и скриптам для requirejs.config () #для внешних библиотек не забываем указывать «external: true» paths: main: location: @AcmeDemoBundle/Resources/assets/js/main jquery: location: //ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min external: true underscore: location: //cdnjs.cloudflare.com/ajax/libs/underscore.js/1.6.0/underscore-min external: true backbone: location: //cdnjs.cloudflare.com/ajax/libs/backbone.js/1.1.2/backbone-min external: true text: location: @AcmeDemoBundle/Resources/assets/js/vendor/text bootstrap: location: //maxcdn.bootstrapcdn.com/bootstrap/3.2.0/js/bootstrap.min external: true test: location: @AcmeWebBundle/Resources/assets/js/test QUnit: location: %kernel.root_dir%/…/node_modules/qunitjs/qunit/qunit #конфиг shim соответственно shim: bootstrap: deps: [jquery] QUnit: deps: [jquery] exports: «QUnit» test: deps: [QUnit] exports: «test» И, соответственно, установить библиотеку QUnit, на которую мы ссылаемся в QUnit.location: npm install qunit В кульминации пишем наши первые тесты: #src/Acme/WebBundle/Resources/assets/js/tests/user/user.js define ( [«QUnit», «bundles/user/models/user»], function (QUnit, User) {
«use strict»;
var run = function () { QUnit.module («Тест для Backbone модели пользователя»);
QUnit.test («Проверка на корректность дефолтных значений», function () {
// Количество ожидаемых проверок QUnit.expect (3);
var user = new User (); // Проверка дефолтных значений модели пользователя QUnit.equal (user.get («name»), «User name», «Дефолтное имя соответствует 'User name'»); QUnit.equal (user.get («email»), «example@example.com», «Дефолтнsый Email соответствует 'example@example.com'»); QUnit.equal (user.get («telephone»),»111–11–11», «Дефолтнsый телефон соответствует '111–11–11'»); }); return {run: run} } );
#src/Acme/WebBundle/Resources/assets/js/tests/user/user2.js define ( [«QUnit», «bundles/user/models/user»], function (QUnit, User) {
«use strict»;
var run = function () { QUnit.module («Тест2 для Backbone модели пользователя»);
QUnit.test («Может быть создан объект пользователя и изменены значения по дефолту», function () {
QUnit.expect (3);
// Создаем объект User с определенными недефолтными значениями var user = new User ({ name: «Vasily Pupkin», email: «vasily@pupkin.com», telephone:»333–22–11» });
// Проверяем правильность сохраненных значений QUnit.equal (user.get («name»), «Vasily Pupkin», «Name Correct!»); QUnit.equal (user.get («email»), «vasily@pupkin.com», «Email Correct!»); QUnit.equal (user.get («telephone»),»333–22–11», «Telephone Correct!»); }); }; return {run: run} } ); Напишем модель, которая отвечала бы нашим тестам: #src/Acme/WebBundle/Resources/assets/js/bundles/user/models/user.js define ([«backbone»], function (Backbone) {
«use strict»;
return Backbone.Model.extend ({ defaults: { name: «User name», email: «example@example.com», telephone:»111–11–11» } }); }); Теперь, если мы обратимся по адресу http://example.com/_tests («example.com» стоит заменить на свой девелоперский хост), то сможем увидеть примерно следующее: Для лучшего понимания структуры и базовой подготовки нашего проекта советую прочесть предыдущую статью.
В результате нехитрой проделанной работы мы получили возможность тестировать RequireJS модули нашего яваскрипт приложения в контексте фреймворка Symfony2, как в «дев», так и в «прод» окружении. Хочу отметить, что это лишь один из вариантов возможных подходов к тестированию JS проекта, который совершенно не претендует на звание оптимального для различных ситуаций.
