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

Добрый день хабр.
Вчера вышла версия 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();  // добавит полный трейс
        })();
    })();
})();

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

test.time.it(someThing());

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

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

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

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

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

  test.done();

  

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

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

  

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

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

  

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

  test.it(true).comment('выведет только этот тест').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 секунды в консоли будет:

TODO

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

Ссылки

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

P.S.

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

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

Автор: titulusdesiderio

Источник