Modern QA2026Справочник по CLI-командам Vibium: Все 22 команды подробно
Join

Course › 01 Agent Skills for Browser Automation

Cutting-edge · Chapter 01

Справочник по CLI-командам Vibium: Все 22 команды подробно

Updated Jul 2026

Установка

npm install -g vibium
npx skills add https://github.com/VibiumDev/vibium --skill vibe-check

Chrome скачивается автоматически при первом использовании. Ручная настройка браузера не требуется.

Команды навигации

vibe-check navigate <url>

Перейти на страницу. Ожидает, пока страница достигнет состояния «loaded».

vibe-check navigate https://example.com
vibe-check navigate https://app.example.com/dashboard

# С ожиданием после навигации (полезно для SPA, загружающихся асинхронно)
vibe-check navigate https://app.example.com --wait-open 3

Граничные случаи:

  • Относительные URL не поддерживаются — всегда используйте полные URL
  • При неудачной навигации (DNS, тайм-аут) команда завершается с ненулевым кодом
  • Для SPA страница может «загрузиться» до отрисовки JavaScript — используйте --wait-open или vibe-check wait после

vibe-check url

Вывести текущий URL страницы. Полезно для проверки после перенаправлений.

vibe-check url
# → https://example.com/

vibe-check title

Вывести заголовок страницы (содержимое элемента <title>).

vibe-check title
# → Example Domain

Команды чтения контента

vibe-check text

Получить весь видимый текст со страницы. Очищает HTML, возвращает простой текст.

vibe-check text
# → "Example Domain\nThis domain is for use in illustrative examples..."

# Получить текст конкретного элемента
vibe-check text "h1"
# → "Example Domain"

vibe-check text ".error-message"
# → "Invalid credentials"

Когда использовать: Проверка содержимого страницы, чтение сообщений об ошибках, извлечение данных для утверждений. Это основной инструмент для агента, чтобы «видеть», что находится на странице.

vibe-check html

Получить HTML страницы. По умолчанию innerHTML, используйте --outer для outerHTML.

vibe-check html
# → полный HTML страницы

vibe-check html --outer
# → включает теги корневого элемента

Когда использовать: Когда нужна фактическая структура DOM, а не только текст. Полезно для отладки проблем с макетом или поиска селекторов.

vibe-check find "<selector>"

Получить подробную информацию об одном элементе: имя тега, текстовое содержимое, координаты ограничивающего прямоугольника.

vibe-check find "button.submit"
# → { tag: "button", text: "Submit", x: 200, y: 450, width: 120, height: 40 }

Когда использовать: Перед взаимодействием с элементом — убедитесь, что он существует, и проверьте его свойства. Ограничивающий прямоугольник полезен для понимания макета.

vibe-check find-all "<selector>"

Найти все совпадающие элементы. Используйте --limit N для ограничения результатов.

vibe-check find-all "a"
# → Список всех ссылок на странице

vibe-check find-all ".product-card" --limit 5
# → Первые 5 карточек товаров

Когда использовать: Исследование структуры страницы, подсчёт элементов, построение списков для итерации.

vibe-check eval "<javascript>"

Выполнить произвольный JavaScript в контексте страницы. Вывести возвращаемое значение.

# Получить все URL ссылок как JSON
vibe-check eval "JSON.stringify([...document.querySelectorAll('a')].map(a => a.href))"

# Проверить localStorage
vibe-check eval "localStorage.getItem('auth_token')"

# Получить вычисленный стиль
vibe-check eval "getComputedStyle(document.querySelector('.alert')).backgroundColor"

# Посчитать строки таблицы
vibe-check eval "document.querySelectorAll('table tbody tr').length"

Когда использовать: «Аварийный выход» для всего, что не могут сделать другие команды. Сложные DOM-запросы, инспекция состояния JavaScript, вычисляемые значения. Очень мощная команда, но требует знания CSS/JS.

vibe-check screenshot -o file.png

Сделать скриншот области просмотра в формате PNG.

vibe-check screenshot -o before-login.png
vibe-check screenshot -o after-login.png

Когда использовать: Визуальная верификация, отладка (увидеть состояние страницы при сбое), формирование доказательной базы тестирования. Скриншоты сохраняются в текущий каталог по умолчанию.

Команды взаимодействия

vibe-check click "<selector>"

Кликнуть по элементу. Автоматически ожидает, пока элемент станет интерактивным (видимый, стабильный, получает события, включён).

vibe-check click "button[type=submit]"
vibe-check click "#login-btn"
vibe-check click "a[href='/dashboard']"

Как это работает внутри:

  1. Опрашивает существование элемента (до 30 с)
  2. Выполняет все пять проверок интерактивности
  3. Получает ограничивающий прямоугольник элемента
  4. Вычисляет координаты центра
  5. Отправляет BiDi input.performActions с перемещением указателя + клик

vibe-check type "<selector>" "<text>"

Ввести текст в элемент ввода. Автоматически ожидает интерактивности + редактируемости.

vibe-check type "input[name=email]" "user@example.com"
vibe-check type "#password" "secret123"
vibe-check type "textarea.comment" "This is my comment"

Важно: Текст вводится посимвольно, вызывая события keydown, keypress, input и keyup — точно как реальный пользователь. Команда НЕ просто устанавливает свойство value.

vibe-check hover "<selector>"

Навести курсор на элемент. Вызывает события mouseenter/mouseover.

vibe-check hover ".dropdown-trigger"
# → появляется выпадающее меню
vibe-check click ".dropdown-item:first-child"

Когда использовать: Выпадающие меню, всплывающие подсказки, состояния при наведении, раскрывающие контент.

vibe-check scroll [direction]

Прокрутить страницу или конкретный элемент.

vibe-check scroll down
vibe-check scroll up
vibe-check scroll down --amount 500        # пикселей
vibe-check scroll down --selector ".panel"  # прокрутка внутри элемента

vibe-check keys "<combo>"

Нажать клавиши. Поддерживает модификаторы и названия клавиш.

vibe-check keys "Enter"
vibe-check keys "Control+a"          # Выделить всё
vibe-check keys "Shift+Tab"          # Обратный tab
vibe-check keys "Control+Shift+k"    # Пользовательская комбинация
vibe-check keys "Escape"             # Закрыть диалог

Названия клавиш: Enter, Tab, Escape, Backspace, Delete, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Home, End, PageUp, PageDown, Control, Shift, Alt, Meta

vibe-check select "<selector>" "<value>"

Выбрать вариант из выпадающего списка (<select>) по значению.

vibe-check select "#country" "US"
vibe-check select "select[name=role]" "admin"

Команды ожидания

vibe-check wait "<selector>"

Ожидать, пока элемент достигнет определённого состояния.

# Ожидать видимости элемента (по умолчанию)
vibe-check wait ".modal"

# Ожидать исчезновения элемента
vibe-check wait ".loading-spinner" --state hidden

# Ожидать появления элемента в DOM (даже если не видим)
vibe-check wait "#data-loaded" --state attached

# Пользовательский тайм-аут
vibe-check wait ".slow-content" --timeout 60000  # 60 секунд

Состояния:

Состояние Значение
visible (по умолчанию) Элемент существует и видим
hidden Элемент не существует или не видим
attached Элемент существует в DOM (может быть как видимым, так и невидимым)

Команды вкладок

vibe-check tabs

Список всех открытых вкладок с их индексом и URL.

vibe-check tabs
# → 0: https://example.com (active)
# → 1: https://docs.example.com

vibe-check tab-new [url]

Открыть новую вкладку, опционально с переходом по URL.

vibe-check tab-new
vibe-check tab-new https://docs.example.com

vibe-check tab-switch <index|url>

Переключиться на вкладку по её индексу или URL.

vibe-check tab-switch 0
vibe-check tab-switch https://docs.example.com

vibe-check tab-close [index]

Закрыть вкладку. По умолчанию — текущую.

vibe-check tab-close
vibe-check tab-close 1

Команды Daemon

vibe-check daemon start

Запустить фоновый daemon. Daemon поддерживает Chrome в рабочем состоянии между командами для более быстрого выполнения.

vibe-check daemon status

Проверить, работает ли daemon.

vibe-check daemon stop

Остановить daemon и закрыть браузер.

Глобальные флаги

Флаг Описание Пример
--headless Скрыть окно браузера vibe-check navigate https://example.com --headless
--json Вывод в формате JSON vibe-check find "h1" --json
--oneshot Режим одноразового использования (без daemon) vibe-check navigate https://example.com --oneshot
-v, --verbose Отладочное логирование vibe-check click "button" -v
--wait-open N Ожидать N секунд после навигации vibe-check navigate https://spa.example.com --wait-open 3
--wait-close N Держать браузер открытым N секунд перед закрытием Полезно для отладки

Типовые паттерны автоматизации тестирования

Поток авторизации

vibe-check navigate https://app.example.com/login
vibe-check type "input[name=email]" "test@example.com"
vibe-check type "input[name=password]" "TestPass123"
vibe-check click "button[type=submit]"
vibe-check wait "h1"  # Ожидать загрузки дашборда
vibe-check text "h1"  # Проверка: "Welcome, Test User"

Валидация формы

vibe-check navigate https://app.example.com/register
vibe-check click "button[type=submit]"              # Отправить пустую форму
vibe-check text ".error"                              # Прочитать сообщения об ошибках
vibe-check screenshot -o validation-errors.png

Извлечение данных

vibe-check navigate https://app.example.com/users
vibe-check eval "JSON.stringify([...document.querySelectorAll('tr')].map(r => r.textContent))"

Многостраничный поток

vibe-check navigate https://shop.example.com
vibe-check click ".product:first-child a"
vibe-check click "#add-to-cart"
vibe-check navigate https://shop.example.com/cart
vibe-check text ".cart-total"
vibe-check click "#checkout"