Artifact fc14d28031bf15ee1a4568f357c3278e0c660c2a:

D 2011-11-17T18:51:33.234
L DevTools/testrunner.js
P 6d595652a0c2eb5ec23a7d92757fed766826ddb3
U kuntashov
W 3425
Скрипт <b>TestRunner</b> (testrunner.js)

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

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

<img src="raw?name=8daf60c9f750b4d229a49f711a8bea724b424470&m=image/png"/>

<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 7926d5a93ae4e2690649d7fddc9cae14