Команды для работы с Gemini

Для выполнения теста в реальных браузерах необходимо установить и запустить 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 [пути к файлам с тестами]

Анализ покрытия CSS (в разработке)

Передайте аргумент --coverage (или настройте опцию coverage в конфигурационном файле) для получения отчёта о том, какие из CSS правил были затронуты минимум одним тестом полностью (выделены зелёным цветом в отчёте), частично (жёлтым) или не затронуты вообще (красным).

Стандартные аргументы командной строки

  • --config, -c – выбрать используемый конфигурационный файл;

  • --grep PATTERN – исполнять только те наборы, название которых соответствуют регулярному выражению;

  • --browser ID — исполнять наборы только в заданном браузере. Опцию можно указать несколько раз; Может быть также задана переменной среды GEMINI_BROWSERS. В случае, если задана и опция и переменная среды будет использована опция.

  • --help – отобразить справку;

  • --version – отобразить текущую версию.

Переопределение настроек

Смотрите документацию по настройке gemini.

Автодополнение команд

Чтобы настроить автодополнение команд по нажатию клавиши Tab, добавьте строку . <(gemini completion) в файл конфигурации командной строки (к примеру, файл ~/.bashrc для bash или файл ~/.zshrc для zsh).