Для выполнения теста в реальных браузерах необходимо установить и запустить Selenium Server.
Без Selenium Server вы можете использовать только PhantomJS. Перед началом использования Gemini запустите PhantomJS в режиме веб-драйвера:
phantomjs --webdriver=4444При наличии нескольких тестовых наборов необходимо сделать снимок эталонного изображения:
gemini gather [пути к файлам с тестами]Если не указан ни один путь, будет прочитан каждый .js-файл из директории gemini.
По умолчанию, конфигурация загружается из файла .gemini.yml текущей
директории, а снимки будут сохранены в папку gemini/screens. Чтобы указать
другой файл конфигурации, используйте аргументы --config или -c.
Рекомендуется сохранять собранные эталоны вместе с кодом в системе контроля версий.
Для сравнения вашего эталонного изображения с текущим состоянием блока используйте следующую команду:
gemini test [пути к файлам с тестами]Пути и конфигурация обрабатываются таким же образом, как в команде gather.
Каждое состояние, отличающееся от эталонного изображения, будет считаться неуспешно пройденным тестом.
По умолчанию, в консоли отображаются только имена состояний. Для получения более подробной информации вы можете использовать HTML-отчёт:
gemini test --reporter html [пути к файлам с тестами]В результате применения команды создается HTML-файл в директории
gemini-report, в котором отображены эталонное и текущее изображения, а также
разница между ними для каждого состояния в каждом браузере.
Доступные отчёты:
flat(стандартный отчёт);vflat(расширенный отчет);html(отчёт в HTML c изображениями).
Вы можете сгенерировать несколько отчётов одновременно используя несколько
аргументов —-reporter:
gemini test --reporter flat --reporter html [пути к файлам с тестами]Передайте аргумент --coverage (или настройте опцию coverage
в конфигурационном файле) для получения отчёта о том, какие из CSS правил были
затронуты минимум одним тестом полностью (выделены зелёным цветом в отчёте),
частично (жёлтым) или не затронуты вообще (красным).
-
--config,-c– выбрать используемый конфигурационный файл; -
--grep PATTERN– исполнять тоÐ 3A8B »ько те наборы, название которых соответствуют регулярному выражению; -
--browser ID— исполнять наборы только в заданном браузере. Опцию можно указать несколько раз; Может быть также задана переменной средыGEMINI_BROWSERS. В случае, если задана и опция и переменная среды будет использована опция. -
--help– отобразить справку; -
--version– отобразить текущую версию.
Смотрите документацию по настройке gemini.
Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку
. <(gemini completion) в файл конфигурации командной строки (к примеру, файл
~/.bashrc для bash или файл ~/.zshrc для zsh).