For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/testing.md (or send Accept: text/markdown).
Стратегия тестирования
Поймите, что устанавливают детерминированные, браузерные, базовые и провайдерские проверки.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.
1. Откройте корневой файл package.json репозитория, чтобы просмотреть команды проверки.
2. Из этой корневой папки запустите corepack pnpm test для автоматических модульных тестов, а затем corepack pnpm --filter @supastack/web typecheck для проверок Web TypeScript.
3. Чтобы узнать о поведении браузера, запустите веб-приложение и запустите corepack pnpm test:e2e. Ожидается: каждая команда сообщает свой результат; модульный тест не доказывает, что реальная база данных, поставщик платежей, служба электронной почты или телефон работают.
Стандартный набор тестов использует детерминированные fake/локальные адаптеры. Браузерные тесты покрывают взаимодействия пользователя; приёмка базы и smoke внешних провайдеров — отдельные шлюзы. Запускайте проверки, относящиеся к изменённому поведению, до расширения области.
corepack pnpm test
corepack pnpm check
corepack pnpm build
corepack pnpm test:e2e
corepack pnpm test:e2e:productionКоманды для копирования
Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.
corepack pnpm test
corepack pnpm --filter @supastack/web typecheck
corepack pnpm test:e2eРабочий процесс внедрения
Для изменений поведения сначала пишите падающий приёмочный тест. Соединяйте успешный доступ с отклонёнными анонимными и межворкспейсными запросами. Для форм и потоков задач проверяйте также поведение загрузки, ошибки и восстановления, а не только удачный путь.
Перехваченный браузерный ответ доказывает, что интерфейс отвечает на эту фикстуру. Он не доказывает персистентность аутентификации, обработку платежей, доставку провайдера или колбэк физического устройства.
Проверка и устранение неполадок
Если тест базы данных сообщает, что он был пропущен, настройте изолированную тестовую базу данных, прежде чем сообщать о покрытии базы данных. Если веб-вкладка находится на порту 3001, это отдельный сервер apps/docs; веб-приложение комплекта запускается через порт 3000. Если при первом запуске Windows Playwright произошел сбой, дождитесь завершения установки браузера и повторно запустите команду, завершившуюся сбоем; никогда не отключайте общесистемную безопасность, чтобы обойти эту проблему.
Если тест, зависящий от базы, пропускается, настройте его изолированную тестовую базу до заявления о прохождении этого шлюза. Если браузерный раннер выдаёт проходящие утверждения, но зависает при завершении, сообщайте оба факта; зависший процесс — не чисто успешная команда.
В Windows время первого запуска браузера может истечь, пока Defender сканирует вновь установленные браузеры Playwright или зависимости. Дайте завершению установки, повторно запустите неудавшийся пакет с помощью corepack pnpm test:e2e или corepack pnpm test:e2e:production и проверьте его трассировку и историю защиты Defender, если произойдет повторный сбой. Оставьте общесистемную защиту включенной.
Локальный браузер владеет портом 3100 и отказывается повторно использовать процесс, уже прослушивающий его. Установите для PLAYWRIGHT_PORT свободный порт перед corepack pnpm test:e2e, если другое приложение владеет портом 3100; это не позволяет тестам незаметно ориентироваться на другой проект.