Добрый день хабр.
Вчера вышла версия 1.1.0 test.it — фреймворка для тестирования js кода.
Он, наконец, обзавёлся функционалом, отсутствие которого делало его неполноценным:
Кто не любит много слов — Сайт на котором можно увидеть код в действии, GitHub, Wiki
Звено цепи .addtrace(level) — добавляет к тесту/группе trace — список строк, приведших к его исполнению.
level — задаёт количество выводимых строк (или глубину областей видимости, на которую будет подниматься trace).
Метод был добавлен по просьбе пользователя vk Denya Tatarinov, с пояснением, что это полезно для наблюдения за большим количеством асинхронных вызовов (тестов).
Для данной задачи хватает вывода только одной (текущей) строки, но мало ли кому понадобиться отследить какой-нибудь запутанный код.
Подготовитель цепи .time — добавляет к выводу теста время, затраченное на его исполнение (или исполнение функции результат которой был передан тесту)
Обратите внимание, что это не метод, а именно аттрибут. Не ставьте после него скобки!
Подготовитель цепи .exclude — предотвращает попадание теста или группы в стек текущего уровня. Это тоже атрибут не ставьте после него скобки!
Может быть полезен для асинхронных тестов.
.done() — в зависимости от того, как и где был вызван выводит:
Благодаря новому поведению .done() (и немного .exclude) теперь доступны асинхронные тесты:
теперь, помимо шлифовки уже сделанного я ставлю приоритетную задачу — порт на node.js и подобные ему языки(?).
Сайт на котором можно увидеть код в действии, GitHub, Wiki
Пока занимался рефакторингом, задался вопросом, а кому собственно нужны test.them и test.types? В связи с чем хочу задать вопрос сообществу, какими тестами вы пользуетесь чаще всего? Какие тесты вам в принципе нужны?
В опросе будут указаны тесты только из этого фреймворка, но в комментариях вы можете высказываться относительно тестов в других фреймворках, в том числе для других языков.
Вчера вышла версия 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? В связи с чем хочу задать вопрос сообществу, какими тестами вы пользуетесь чаще всего? Какие тесты вам в принципе нужны?
В опросе будут указаны тесты только из этого фреймворка, но в комментариях вы можете высказываться относительно тестов в других фреймворках, в том числе для других языков.
Только зарегистрированные пользователи могут участвовать в опросе. Войдите, пожалуйста.
Какими из тестов вы пользуетесь/будете пользоваться
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 пользователей. Воздержался 31 пользователь.