Pull to refresh

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

Reading time 3 min
Views 4.9K
Добрый день хабр.
Вчера вышла версия 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? В связи с чем хочу задать вопрос сообществу, какими тестами вы пользуетесь чаще всего? Какие тесты вам в принципе нужны?

В опросе будут указаны тесты только из этого фреймворка, но в комментариях вы можете высказываться относительно тестов в других фреймворках, в том числе для других языков.
Only registered users can participate in poll. Log in, please.
Какими из тестов вы пользуетесь/будете пользоваться
100% it(value) — проверка на не-ложность 14
92.86% it(value1,value2) — проверка равенства 13
28.57% them(arrayOfValues) — проверка на не-ложность элементов в массиве 4
57.14% type(value,type) — проверка типа на соответствие указанному 8
21.43% types(arrayOfValues[, type]) — проверка типов элементов в массиве на соответствие друг другу и указанному 3
14 users voted. 31 users abstained.
Tags:
Hubs:
+6
Comments 12
Comments Comments 12

Articles