Вышел test.it v1.1.0 — что дальше?

в 4:39, , рубрики: framework, javascript, tdd, test-driven development, testing, unit-testing, велосипед, велосипедостроение, разработка через тестирование, тестирование, юнит-тестирование, юнит-тесты, метки: , , , , , , , , , , ,

Добрый день хабр.
Вчера вышла версия 1.1.0 test.it — фреймворка для тестирования js кода.
Он, наконец, обзавёлся функционалом, отсутствие которого делало его неполноценным:

  • Асинхронные тесты/группы
  • Запуск отдельных тестов/групп

А так же прочими мелочами.

картинка для привлечения внимания
Кто не любит много слов — Сайт на котором можно увидеть код в действии, GitHub, Wiki

Ченджлог

  • Изменения под капотом
    • серьёзный рефакторинг — изменение технологии цепочности и наследования
    • возможность запуска в безоконной среде (в которой нету объекта window, например node.js)
      Это подготовительная операция для порта под node.js, angular.js и им подобным

  • Изменения в интерфейсе
    .done() получил дополнительный функционал как метода завершающего цепь.
    Появились новые методы и атрибуты:

    • звено цепи .addTrace(level)
    • подготовитель цепи .time
    • подготовитель цепи .exclude

  • Исправлены:
    • огромное количество грамматических ошибок (спасибо tenphi и asmgf)
    • баг с расчётом времени у root при многократном вызове test.done()

  • Обновлены Вики, сайт и пример

Новые возможности

Звено цепи .addtrace(level) — добавляет к тесту/группе trace — список строк, приведших к его исполнению.
level — задаёт количество выводимых строк (или глубину областей видимости, на которую будет подниматься trace).
Метод был добавлен по просьбе пользователя vk Denya Tatarinov, с пояснением, что это полезно для наблюдения за большим количеством асинхронных вызовов (тестов).

У меня есть хорошая привычка, логгировать каждый ajax запрос. точнее ответ от сервера. и когда случается какая то херь, я бы хотел знать в какой строчке это случилось) не писать жеж что вот чувак, это 45 строчка в каждом вызове. + помогает ориентироваться по коду

Для данной задачи хватает вывода только одной (текущей) строки, но мало ли кому понадобиться отследить какой-нибудь запутанный код.

Пример и скриншот

(function firstFunction() {
    (function secondFunction() {
        (function lastFunction() {
            test.it(1).addTrace(0); // добавит только текущую строку
            test.it(1).addTrace();  // добавит полный трейс
        })();
    })();
})();

addTrace

Подготовитель цепи .time — добавляет к выводу теста время, затраченное на его исполнение (или исполнение функции результат которой был передан тесту)
Обратите внимание, что это не метод, а именно аттрибут. Не ставьте после него скобки!

Пример и скриншот

test.time.it(someThing());

time

Подготовитель цепи .exclude — предотвращает попадание теста или группы в стек текущего уровня. Это тоже атрибут не ставьте после него скобки!
Может быть полезен для асинхронных тестов.

Пример

alert(test.exclude.it(someThing).result()); //выдаст alert с результатом теста
test.exclude.group('some group',function(){ ... }).done(); //выведет группу в консоль

Вывод отдельных тестов и групп

Наконец все эти .group обрели смысл!
.done() — в зависимости от того, как и где был вызван выводит:

  • Как метод объекта test вне групп — выведет результат как и раньше.
    Пример

    test.done();

    test.done

  • Как метод объекта test внутри группы — выведет эту группу включая все тесты и подгруппы, которые успели туда попасть.
    Пример

    test.group('group of tests',function(){
        test.it(false);
        test.done();
        test.it(true);
    });

    test.done in group scope

  • Как оканчивающее звено в цепи групп — выведет последнюю группу в цепи
    Пример

    test.group('group of tests',function(){
        test.it(true);
        test.it(false);
    }).done();
    // или
    test.group('group of tests').done();
    

    test.group.done

  • Как оканчивающее звено в цепи теста — выведет этот тест
    Пример

    test.it(true).comment('выведет только этот тест').done();

    test.it.done

Асинхронные тесты

Благодаря новому поведению .done() (и немного .exclude) теперь доступны асинхронные тесты:

var a = false; // переменная, которую мы изменим через 2 секунды
setTimeout(function () {a=true}, 2000) // асинхронное (через время) изменение переменной
setTimeout(function () {
     test.group('async tests',function(){
        test.it(a).comment('переменная ещё не изменилась');
     }).comment('async group').done(); // вывод результата
}, 1000);
setTimeout(function () {
    test.exclude.it(a).comment('переменная уже изменилась').done(); // вывод результата, без добавления его в root
}, 3000);

Через ~3 секунды в консоли будет:
async

TODO

теперь, помимо шлифовки уже сделанного я ставлю приоритетную задачу — порт на node.js и подобные ему языки(?).

Ссылки

Сайт на котором можно увидеть код в действии, GitHub, Wiki

P.S.

Пока занимался рефакторингом, задался вопросом, а кому собственно нужны test.them и test.types? В связи с чем хочу задать вопрос сообществу, какими тестами вы пользуетесь чаще всего? Какие тесты вам в принципе нужны?

В опросе будут указаны тесты только из этого фреймворка, но в комментариях вы можете высказываться относительно тестов в других фреймворках, в том числе для других языков.

Автор: titulusdesiderio

Источник

Поделиться

* - обязательные к заполнению поля