D 2011-11-17T18:44:19.793
L DevTools/testrunner.js
U kuntashov
W 3347
Скрипт <b>TestRunner</b> (testrunner.js)

Скрипт для автоматического выполнения юнит-тестов других скриптов-аддинов разработчиками.

В настоящий момент скрипт умеет следующее:
<ul>
<li>Загружать в дерево как отдельный тестовый скрипт, так и все тестовые скрипты из выбранного каталога.</li>
<li>Выполнять пакетно автоматически тесты с подсчетом статистики и выводом диагностических сообщений.</li>
<li>Выполнять подсчет выполненных/проваленных тестов.</li>
</ul>

<h3>Зависимости</h3>
Скрипт основан на пулярной библиотеке юнит-тестирования для JavaScript [http://jsunit.net] и использует для своей работы ее порт для Снегопата, который также находится в репозитории: [/finfo?name=Libs/jsUnitCore.js|Libs/jsUnitCore.js].

Эта же библиотека рекомендуется авторам скриптов как библиотека для написания тестов. 

<h3>Требования к скриптам-тестам</h3>

Тестовый скрипт должен в имени файла иметь префикс "test". Это необходимо, чтобы TestRunner мог различать, какие скрипты в каталоге являются тестовыми, а какие - вспомогательными, которые загружать не надо.

Тест-кейсы - это макросы, т.е. функции с префиксом macros, но дополненным словом "Test". Другие макросы и функции из скрипта считаются служебными и не загружаются в дерево тестов.

Никаких других специальных требований к тестовым скриптам и их содержимому не предъявляются.

<h3>Примеры тестовых скриптов</h3>

Полноценные реальные тестовые скрипты, предназначенные для выполнения при помощи TestRunner'а, находятся в подкаталоге Tests\Automated каталога scripts.

Ниже приводится в качестве примера простейший тестовый скрипт.

Имя файла: textExampleTest.js

<pre>$engine JScript
$uname ExampleTest
$dname Пример тестового скрипта
$addin stdlib

// Подключаем библиотеку jsUnitCore.js
stdlib.require('jsUnitCore.js', SelfScript);

function macrosTest2plus2()
{
    assertEquals("Операция сложения не работает!", 4, 2 + 2);
}</pre>

<h3>Полезные ссылки</h3>
<ul>
<li>[/finfo?name=DevTools/testrunner.js|История версий скрипта]</li>
<li>[http://jsunit.net/|Документация по jsUnit]</li>
</ul>




Z bda023d290c6531fd553cce2cb54df7f