- Сделать в GitHub действие "Fork" для этого проекта, чтобы скопировать проект в свою чётную запись.
- Установить в систему Git с сайта https://git-scm.com/downloads (если уже не сделано).
- Установить в систему любой GUI для работы с Git (если уже не сделано). Например https://desktop.github.com/ или https://tortoisegit.org/. Многие редакторы кода имеют плагин или всроенную поддержку Git.
- Склонируйте проект по адресу из своего аккаунта локально в файловую систему.
Начальная установка и настройка проект предпологает несколько шагов, которые должны быть проделаны единожды в начале.
- Установить NodeJS со сайт http://nodejs.org. Установите последнюю версию.
- Запустите /tasks/setup.bat для автоматической установки всех модулей из открытых репозиториев. Это внешние зависимости необходимые для работы инфраструктуры разработки проект.
Исходный код проекта находится в папке /src. Кода задания следует писать только в файле /src/index.js. При автоматической проверке будет проверяться только он.
Можно писать лишний код во время разработки для удобства проверки работоспособности своих функций. Такой код будет игнорироваться и пропускаться авто-тестами. Во внимание будет браться только код необходимый для выполнения задания. Не советуется использовать такие функции как alert() или document.write() для вывода сообщений, т.к. это может нарушить корректную работу тестов. Для вывода сообщений предлагается использовать метода объекта console.
Следующие действия можно выполнять каждый раз, когда вы приступаете к работе с проектом.
Чтобы активировать автоматическую перезагрузку HTML-страниц проекта или тестов, запустите файл /tasks/livereload.bat. После этого нужно запустить или обновить главную страницу проекта либо тестов. Не закрывайте запущенную командную строку до тех пор, пока не нужно прекратить действие живой перезагрузки. Такая возможность всроена во многие редакторы кода, но данная инфраструктура позволяет сделать живую перезагрузку не зависимо от этого.
Тесты запускают JavaScript код проекта и проверяют на соответствие требованиям и спецификациям. В код будут переданы тестовае входящие данны, а результат выполнения будет проверен соответствие ожидаемому. Возможны 2 альтернативных способа запуска тестов: через браузер или через командную строку.
Запустите в браузере /test/index.html. Тесты запустятся в текущем браузере и код будет проверен на работоспособность именно в нём. Вы увидете отчёт на странице браузера. При изменениях в коде проект странице следует обновлять вновь для запуска тестов с начала. Но это не обязательно делать, если включён Live reload. Тогда страница будет перезагружаться автоматически при любом пересохранении исходного кода проекта.
Запустите файл /tasks/test.bat, чтобы увидеть отчёт по тестам. При изменениях в коде этот файл следует запускать вновь, чтобы увидеть новый статус.