Тесты
Откройте Инструменты рабочей области → Тесты на компьютере или Инструменты → Тесты на мобильном устройстве, затем выберите проект. Раздел «Тесты» читает тестовые файлы проекта как текст и показывает каждый найденный тест: папки, файлы, имена тестов и код вокруг каждого теста. При чтении ничего не запускается, не импортируется и не устанавливается; ваши тесты выполняются, только когда вы сами их запускаете.
В верхней части страницы расположены строка состояния и две карточки. Модульные тесты и Регрессионные тесты показывают, сколько тестов прошло при последнем запуске, какие тесты не прошли или нестабильны, недавние запуски и кнопку Запустить. Под ними единая панель вкладок содержит Модульные тесты, Регрессионные тесты, Интеграция и E2E, Проверки (линтинг, типы, сборка и проверочные скрипты) и История.
Прочитайте строку состояния
Строка над карточками сразу даёт ответ по последним результатам ваших тестов:
- Ещё не проверено — пока не запускался ни один тест. Запустите тесты один раз, чтобы увидеть состояние проекта.
- Если тесты не проходят, строка показывает их число и кнопку Показать ошибки: непройденные тесты открываются с фильтром Ошибка, причём первым идёт регрессионный тест, если вернулась уже исправленная ошибка.
- Если есть нестабильные тесты (они не прошли, а затем прошли при повторной попытке), строка показывает их число и кнопку Показать нестабильные тесты.
- В остальных случаях строка показывает, сколько тестов проходит, сколько ещё не запускалось и когда завершился последний запуск.
В подсчёт входят модульные, интеграционные и сквозные тесты, а также проверки. Регрессионные тесты используют те же самые тесты, поэтому дважды не считаются.
Рядом с кнопкой Автоматические запуски строка также показывает Следующий автоматический запуск с его временем или Автоматические запуски выключены. Если последний автоматический запуск не смог начаться, строка объясняет почему.
Просмотрите свои тесты
Каждая вкладка группирует тестовые файлы по папкам. Откройте папку, чтобы увидеть её файлы, затем выберите файл: его тесты появятся справа (на телефоне — на отдельном экране), причём первыми идут непройденные. Для непройденного теста показываются ожидаемое и полученное значения, о которых сообщило средство запуска тестов, и текущий код вокруг строки с ошибкой. Фильтруйте по состояниям Ошибка, Нестабильный или Ещё не запускался либо ищите по имени файла или папки.
Тест, который ни разу не запускался, отмечен как Ещё не запускался. Кольцо успешности никогда не показывает 100 %, если какой-либо тест не прошёл. Состояние всегда обозначается значком и словом, а не только цветом.
Раздел «Тесты» автоматически распределяет файлы по группам: модульные тесты, интеграционные
и сквозные тесты (папки вроде e2e, integration, routes или api, файлы Playwright
и веб-сценарии) и проверки. К проверкам относятся линтинг, типы, сборка и проверочные
скрипты проекта, в том числе скрипты с суффиксом в имени, например contrast:ui-check
или tabs:guard. Если папка попала не в то семейство, откройте её меню ⋯
и выберите Переместить в модульные тесты или Переместить в «Интеграция и E2E».
Запустите тесты
Выберите Запустить модульные тесты, Запустить регрессионные тесты, кнопку запуска папки или файла либо Запустить файл в его подробностях. Предварительно ничего настраивать не нужно: раздел «Тесты» составляет команду на основе скрипта, который уже запускает эти файлы в вашем проекте (сохраняя его параметры), или на основе команды средства запуска тестов по умолчанию, сохраняет её и запускает. Открывается отчёт о запуске с ходом выполнения и кнопкой Остановить. Закрытие приложения не останавливает запуск; результат сохраняется на инстансе.
Пока набор тестов выполняется, строка состояния вверху показывает, насколько он продвинулся, с кнопками Показать ход выполнения, которая снова открывает текущий запуск, и Остановить, которая останавливает весь набор: запуски, которые ещё ждут, так и не начнутся. Можно уйти из раздела тестов и вернуться — ход выполнения сохраняется. Кнопка Запустить модульные тесты показывает Выполняется…, пока набор не закончится, так что повторное нажатие никогда не запустит те же тесты дважды. Если на вашем инстансе нет инструмента тестирования, например pytest, не запущенными остаются только его тесты; остальные выполняются.
Сохранённую команду можно изменить: ⋯ → Изменить команду меняет её исполняемый файл, аргументы, уровень, предварительные условия, сервисы, тестовые данные и предельное время.
Выберите, сколько тестовых файлов выполнять одновременно
Тестовых файлов одновременно рядом со строкой состояния задаёт, сколько тестовых файлов проекта выполняется одновременно. Автоматически, значение по умолчанию, сохраняет собственную настройку каждого инструмента тестирования. Выберите число, не больше числа процессоров вашего инстанса, и каждый запуск проекта, ручной или автоматический, будет выполнять не больше стольких файлов: Node, Vitest, Jest и Playwright следуют этому числу, другие инструменты тестирования сохраняют свою настройку, а запуски проекта тогда идут один за другим. Уже начатый запуск сохраняет своё число.
Тесты всегда выполняются с более низким приоритетом процессора, чем инстанс, поэтому ваши разговоры и приложения остаются отзывчивыми, пока они идут. Эту настройку задаёте только вы: встроенный ассистент может прочитать или изменить её по вашей просьбе, а разговор в проекте никогда её не меняет.
Запускайте тесты по расписанию
Выберите Автоматические запуски рядом со строкой состояния, чтобы запускать тесты проекта по собственному расписанию. У каждого проекта оно одно:
- Запускать тесты автоматически включает или выключает расписание.
- Повторение: каждый час, каждый день, по будням, каждую неделю, каждый месяц или собственное выражение cron. Между запусками должно проходить не меньше 15 минут.
- Часовой пояс: пояс, по которому идёт расписание. Первым предлагается часовой пояс, в котором отображается время; если позже его сменить, сохранённое расписание не сдвинется.
- Что запускать: хотя бы один из вариантов Модульные тесты, Регрессионные тесты, Интеграция и E2E и Проверки.
- Уведомлять: при варианте Только когда что-то не проходит (по умолчанию) об успешных запусках уведомлений нет, а о запуске, который не прошёл, прервался или требует проверки, вы узнаете как обычно; вариант После каждого запуска уведомляет каждый раз.
- Пропущенные запуски: если в запланированное время инстанс был выключен, вариант Запустить один раз, когда экземпляр снова заработает (по умолчанию) наверстывает пропущенное одним запуском, сколько бы сроков ни было пропущено, а вариант Пропускать пропущенные запуски ждёт следующего запланированного времени.
Автоматический запуск — обычный запуск: он обновляет карточки и строку состояния и появляется на вкладке История вместе со своим отчётом. Он никогда не накладывается на предыдущий автоматический запуск. При нехватке памяти или во время обновления он ждёт и повторяет попытки до двух часов; ошибкой это никогда не считается. Если автоматический запуск не может начаться, например потому что предыдущий ещё выполнялся, проект требует проверки или запускать было нечего, строка состояния объясняет причину, а следующий запуск по расписанию проходит как обычно. Вид тестов, в котором нечего запускать, не мешает остальным. После обновления или восстановления автоматические запуски возобновляются сами; время, пропущенное за этот период, обрабатывается согласно настройке Пропущенные запуски.
Расписание задаёте только вы: встроенный ассистент может прочитать или изменить его по вашей просьбе, а разговор в проекте может его прочитать, но никогда не создаёт и не меняет.
Создайте тест
Выберите Новый тест в правом верхнем углу:
- Написать тест с помощью AI: опишите поведение; ИИ предложит тест, а вы проверите его перед сохранением. Ничего не выполняется, пока вы его не запустите.
- Защитить исправленную ошибку: создайте регрессионный тест из тестов, которые её покрывают.
- Веб-сценарий: шаги с нажатиями и проверками во встроенном браузере.
- Добавить команду тестирования: существующий скрипт вашего проекта, например
npm test.
Измените тест
Выберите файл, затем Открыть в редакторе, чтобы изменить его самостоятельно, или Изменить с помощью AI, чтобы открыть новый разговор об этом файле и тесте (ничего не отправляется, пока вы сами не отправите сообщение). Если тест не прошёл, Исправить с помощью AI воспроизводит сбой, исправляет код и повторно запускает тот же тест и ваши регрессионные тесты. Для регрессионного теста кнопка Изменить тесты добавляет или удаляет тесты, которые его защищают.
Запустите регрессионные тесты
Задайте имя коллекции, опишите защищаемое поведение или ошибку и выберите точные сохранённые ревизии групп, случаев или сценариев. Модульные, интеграционные, API- и E2E-тесты могут входить в одну коллекцию без дублирования исходников. Линтинг, типы и сборка остаются отдельными проверками.
Сохраните коллекцию и явно запустите эту ревизию. Полные и частичные выборки помечаются раздельно. Пересекающиеся элементы выполняются один раз; конфликтующие ревизии и пустые выборки отклоняются. Последующие изменения коллекции не меняют состав, зафиксированный в запуске.
Коллекции остаются приватным состоянием инстанса и не экспортируются в Git. Существующие тестовые файлы проекта и явно экспортированные исходники сценариев можно версионировать обычным способом.
Исправленные тесты становятся регрессионными
В любом проекте ошибка оказывается под защитой, как только доказано её исправление, и никому не нужно вести список. Когда тест, который не проходил, проходит после изменения кода, раздел «Тесты» превращает его в регрессионный тест:
- Тест считается исправленным, если он прошёл во всех попытках запуска, а в пяти предыдущих запусках проекта его последний результат был неудачным, причём на другой версии кода. Прохождение после повторной попытки или на неизменённом коде исправлением не считается.
- Каждый исправленный файл становится одним регрессионным тестом с именем первого исправленного в нём теста; этот тест запускает только данный файл с параметрами скрипта вашего проекта. В его защищаемом поведении перечислены исправленные тесты.
- Запуск, исправивший больше пяти файлов, ничего не защищает: столько исправлений сразу обычно означает, что починили окружение, а не ошибки.
- Файл, который уже защищён регрессионным тестом, остаётся без изменений.
При создании ничего не запускается: его включит следующий запуск регрессионных тестов, ваш или автоматический. Изменяйте или удаляйте его, как любой другой регрессионный тест.
Выберите эталон и сравните результаты
Выберите сохранённый запуск в качестве эталона коллекции, затем сравните с ним другой запуск. Эталон — основа сравнения, а не третий режим источника для выполнения. Успешный результат никогда не заменяет его автоматически.
Эталон требует непустого набора полностью наблюдавшихся утверждений, известных ожиданий, изолированных данных и полной прослеживаемости происхождения. Неуспешный эталон позволяет выявлять уже существующие сбои; частичные, импортированные, пропущенные, нестабильные или неполные доказательства не подходят.
Сравнение различает новые регрессии, существующие сбои, исправления, добавления, исчезновения, пропуски, невыполненные случаи и нестабильность. Оно показывает изменения ожиданий и совместимость конфигурации, данных, среды выполнения и цели. Отсутствие в частичной выборке не означает удаление. Полные доказательства сравнения могут включать сбои; полнота не означает успех.
Добавьте веб-сценарий
Отредактируйте поведение, цель, данные, предварительные условия, шаги, утверждения и очистку сценария. Используйте устойчивые локаторы по роли, подписи, тестовому идентификатору или тексту. Это не запись щелчков мышью.
Например, защитите сохранение состояния приложения задач такими шагами:
- Откройте приложение с отдельными тестовыми данными.
- Введите известный заголовок в поле новой задачи и выберите действие добавления.
- Проверьте, что задача видна, затем отметьте её выполненной.
- Перезагрузите страницу.
- Проверьте, что та же задача по-прежнему видна и отмечена как выполненная.
Сохраните сценарий перед запуском. Сохранить исходник теста — отдельное явное действие: выберите путь относительно проекта, чтобы сохранить сгенерированный исходник теста. Экспорт отклоняется, если существующий файл содержит другие байты. Правка экспортированного файла делает его сопоставление недействительным и блокирует повторное выполнение. Проверьте ревизию сценария и её связь с исходником; не перезаписывайте параллельную работу. Прежние доказательства остаются в истории. Подготовка теста не меняет обычные действия приложения «Запустить», «Остановить» или активацию.
Встроенный браузер использует временные контексты Chromium и блокирует service workers. Он не подтверждает работу offline/PWA, Safari, Firefox, нативного Android/iOS-приложения или производительность реального устройства. Соответствие текущей цели исходникам может оставаться неопределённым: тогда успешные браузерные утверждения показывают Успешно, а этот факт указан в разделе Подробности, но запуск не становится полной валидацией или допустимым полным эталоном. Снимок экрана служит доказательством; визуальная регрессия требует выполненного утверждения и явно управляемого визуального эталона.
Изучайте сбои и сохраняйте доказательства
Отчёт о запуске начинается с ответа: Успешно, Ошибка, Нестабильный или фраза о том, почему ответа нет, а также название запущенного, число тестов, длительность и дата. Тесты с ошибками идут первыми, с ожидаемым и полученным значением, если их передал движок; Показать журнал открывает журнал, а Подробности содержат примечания (файлы, изменённые во время запуска, тесты, использовавшие данные самого проекта), сохранённые файлы, описание запуска и сравнение с другим запуском. Журналы и списки ограничены и разбиты на страницы; усечение остаётся заметным.
Успех команды, вердикт, полнота отчёта и происхождение — разные факты. Нулевой код выхода без пригодного отчёта доказывает только успех команды. Ноль случаев, отсутствующие отчёты, аутентификация или зависимости, пропуски и прерывания не подтверждают валидацию. После неуспешной попытки и последующего успеха тест остаётся в статусе Нестабильный; обе попытки сохраняются.
Снимки, трассировки и отчёты, сохранённые инструментом «Тесты», переживают исходную браузерную сессию. Для скачивания нужна аутентификация на инстансе; активный HTML/SVG скачивается как вложение, а не выполняется как отчёт. Отсутствующие или повреждённые доказательства обозначаются явно. Открытие исходника показывает текущий файл проекта, не обещая совпадения его байтов с историческим тестом. Поздние правки не переписывают прежние результаты.
Действие Остановить ждёт завершения принадлежащих запуску дочерних процессов и сохраняет посторонние приложения и разговоры. Отказ в очистке остаётся видимым. Закрытие экрана, потеря сети или перевод клиента в фон не останавливают запуск. После подключения вновь откройте его точный отчёт. Если непрерывность нельзя доказать, перезапуск инстанса отмечает выполнение как прерванное и не повторяет команду автоматически. Раздел запусков «Поезда» и уведомления ведут к сохранённому результату инструмента «Тесты».
Превратите ошибку в защищённое поведение
Сохраняйте цепочку: воспроизвести → сохранить красный тест → исправить код → то же ожидание становится зелёным → повторить регрессионную коллекцию. Повторные выполнения создают связанные записи. Изменение, удаление или ослабление утверждений не устраняет дефект автоматически.
Пишите тесты самостоятельно или выберите Описать поведение, чтобы получить редактируемое предложение модульного теста или сценария. Используйте существующие элементы выбора «среда выполнения», «Модель», «Усилия» и аккаунта. Проверьте конкретные утверждения, файлы, данные и предварительные условия; ответьте на оставшиеся вопросы, прежде чем явно отметить проверку готовой и сохранить предложение. Генерация, сохранение и запуск остаются отдельными действиями. Сохранение предложения модульного теста после вашего рассмотрения записывает его тестовый файл в проект; сохранение сценария сохраняет его определение, а необязательный экспорт исходника остаётся отдельным действием. У предложения нет вердикта выполнения. Изменения исходников могут потребовать нового рассмотрения перед сохранением.
Исправить с помощью AI связывает точный сбой с воспроизведением, видимой беседой об исправлении и новой проверкой. Отсутствие воспроизведения, изменившиеся ожидания и неполные регрессионные доказательства остаются явными. Объяснение модели никогда не заменяет утверждения. Локальным тестам модель не нужна; необязательный ИИ использует существующие механизмы учёта провайдера, тарифов и квот. Неизвестная стоимость не равна нулю. См. Учёт использования. Ничто не запускает Ship и не публикует результат.
Квалифицированные движки и необходимые условия
Эти точные версии квалифицированы на уровне исходников под Linux с Node 22.22.2/22.23.2. Зависимости должны уже существовать; инструмент «Тесты» не устанавливает и не обновляет их. Поддержка диапазона версий не подразумевается.
| Движок | Случаи и адресное повторное выполнение | Покрытие и ограничения |
|---|---|---|
| Node test runner 22.22.2 / 22.23.2 | Структурированные случаи, хуки, skipped/todo; прямой запуск текущего исполняемого файла Node. Нет точного повторного запуска случая или истории повторных попыток. | Явное нативное покрытие строк, ветвей и функций с измеренной областью; не более 128 файлов/64 KiB метаданных покрытия. |
| Vitest 4.1.10 | Прямая точка входа; точная выборка сохранённых случаев после сбора под надзором; попытки сохраняют повторы. | Нет квалифицированного покрытия или инверсии ожидаемого провала. Отклоняются обёртки жизненного цикла и конфигурации, которые не могут сохранить плагин доказательств. |
| Jest 30.2.0 | Уникальное полное имя в зафиксированном файле; один выбранный случай на команду, ограниченное число команд для нескольких случаев. | Импорт покрытия отсутствует. Неоднозначные имена, преднастройки, многопроектные/TypeScript-конфигурации и пользовательские раннеры отклоняются. |
| pytest 8.4.2 / CPython 3.10.12 | Прямой Python из виртуального окружения с -m pytest; точные идентификаторы узлов и этапы setup/call/teardown. |
Покрытие, обёртки, распределённый запуск и плагины повторов не квалифицированы. Отсутствующий pytest не устанавливается незаметно. |
| Playwright Test 1.63.0 | Установленный раннер проекта; идентификаторы проекта и повторений, повторные попытки и вложения. Точный повторный запуск случая отсутствует. | Нет покрытия или инверсии ожидаемого провала. Политика браузера проекта отличается от политики встроенного браузера. |
| Пользовательская команда / JUnit | Результат команды без детализации либо случаи, действительно переданные ограниченным отчётом. Точный повторный запуск случая отсутствует. | Покрытие, счётчики и смысл повторов не угадываются; неподдерживаемые диалекты XML остаются недействительными или неполными. |
Пользовательская команда JUnit должна записать текущий отчёт в приватный каталог отчётов
запуска через TEST_REPORT_PATH / TEST_REPORT_DIR или явные подстановки аргументов
{{TEST_REPORT_PATH}} / {{TEST_REPORT_DIR}}. Старый отчёт из рабочей области
не может подтвердить новое выполнение. Импорт внешнего XML доступен через
API/действие tests.importJUnit, а не через кнопку импорта в текущем интерфейсе.
Импортированные счётчики не доказывают локальное выполнение, текущее происхождение или пригодность в качестве эталона.
Выполнение под Linux квалифицировано. Путь владения процессами Windows существует, но выполнение на нативной Windows остаётся неквалифицированным. Выполнение на инстансе macOS сейчас не поддерживается; клиент macOS может управлять поддерживаемым удалённым инстансом. Наличие интерфейса Android/iOS не подтверждает тестирование нативных приложений. Исходники, точный пакет поставки, приватный установленный кандидат, обслуживаемый клиент, публичный релиз и доказательства с физического устройства — разные уровни; один не подтверждает остальные.
Инструменты разговора
Обычные авторизованные разговоры проекта получают пять MCP-инструментов и соответствующие CLI-команды:
aircode_tests_catalog / catalog, aircode_tests_describe / describe,
aircode_tests_run / run, aircode_tests_status / status и
aircode_tests_open / open. Перед изменяющим действием прочитайте схему:
aircode-tests catalog
aircode-tests describe --input '{"action":"tests.launchUnits"}'
aircode-tests run --input '{"action":"tests.units","input":{}}'
Используйте tests.launchUnits для модульных групп или tests.launchRegression для точной
коллекции, с возвращёнными привязками области/ревизии и явным ключом из схемы.
Проект задаётся ограниченными полномочиями сессии; не добавляйте поле project.
--input - принимает ограниченный JSON через стандартный ввод. status принимает
{scopeId,ownerKind,ownerId}; open принимает ту же идентичность или {} для раздела «Тесты».
Не меняйте возвращённый openPath. В MCP используйте те же аргументы
с соответствующим инструментом aircode_tests_*. См. Документация для ИИ.
Запуски из разговора допускают только рецепты и сервисы, распознанные при обнаружении. Используйте распознанный скрипт проекта или запускайте пользовательскую команду из интерфейса владельца.
После потери ответа проверьте статус и используйте тот же ключ и те же входные данные для явной идентичной повторной попытки. Чтение статуса никогда не запускает работу заново. Сессии в режиме планирования и режиме только для чтения не могут записывать; истёкшие или отозванные инструменты требуют обычного возобновления разговора. Эти инструменты не дают общей командной оболочки и не разрешают публичную передачу доказательств. Не редактируйте хранилище и не подделывайте учётные данные, чтобы обойти отказ.
Хранение и отказы с понятным следующим действием
Определения, эталоны и неизменяемые факты выполнения находятся в приватном домене SQLite инструмента «Тесты» на инстансе. Большие журналы, снимки и трассировки хранятся в приватных сопутствующих файлах. Одна резервная копия базы не содержит эти байты: сохраняйте сопутствующие файлы вместе с согласованной резервной копией инстанса. Никогда не копируйте работающую WAL-базу как резервную копию. Уникальные и основные доказательства сохраняются по умолчанию; явно удалить можно только проверенное избыточное вложение завершённого запуска. Общей очистки уникальных доказательств нет. Распознанные секреты скрываются или приводят к отказу; фильтры не могут найти каждый секрет в произвольных журналах, изображениях, архивах и данных проекта.
| Отказ или состояние, требующее внимания | Следующее действие |
|---|---|
| Нет модульных групп / пустая коллекция | Укажите уровень групп и сохраните их либо добавьте точные элементы коллекции. |
| Движок отсутствует или не поддерживается | Проверьте исполняемый файл, установленную зависимость и квалифицированную версию; при необходимости используйте пользовательскую команду с честно указанными ограничениями. |
| Данные не изолированы / источник неопределён | Отчёт показывает «Успешно», а этот факт указан в «Подробностях»; создайте отдельные фикстуры, прежде чем такой запуск сможет стать эталоном. |
| Адресное повторное выполнение недоступно | Повторите полную выборку или изучите её сохранённый отчёт. |
| Исходник изменился / эталон неполон | Проверьте текущие исходники, ожидания и совместимость, затем явно выберите подходящую новую выборку или эталон. |
| Отложено из-за очереди, памяти, диска или квоты | Устраните указанное ограничение ресурса и явно запросите новый запуск или возобновление. Время сброса и повторная попытка не выдумываются. |
| Очистка отклонена / доказательства отсутствуют | Изучите сохранённую причину и доказательства; используйте доступное восстановление доказательств без повторного запуска тестов или ручного удаления приватного состояния. |