Документация1С-Битрикс: Модулиnative.apiРазработчикам

Unit-тесты модуля

В каталоге модуля tests находится набор unit: проверки маршрутизации, безопасности, провайдера, OpenAPI, кеша, токенов и обработки JSON/XML. Разработчики могут запускать его до и после обновления или изменения кода модуля.

Требования

  • PHP CLI версии, поддерживаемой модулем согласно системным требованиям.
  • Расширения PHP dom, json и mbstring.
  • Разрешённая функция PHP exec для проверок в отдельных процессах.
  • Каталог tests вместе с исходниками проверяемой версии модуля.

PHPUnit и Composer не требуются. Установленное ядро Битрикса для этого набора не обязательно: при отсутствии классов ядра используются минимальные тестовые заглушки.

Запуск

Откройте терминал в корне модуля — каталоге с папками install, lib, routes и tests. Запустите набор:

Shell
php tests/run.php unit

Если на сервере несколько версий PHP, используйте путь к нужному интерпретатору в команде запуска. Версия PHP CLI может отличаться от версии, обслуживающей сайт.

Результат

Для каждой проверки выводится PASS, FAIL или SKIP, затем общая статистика. Код завершения 0 означает, что нет ошибок и пропущенных проверок. При FAIL или SKIP код завершения — 1: прочитайте сообщение конкретной проверки и устраните ошибку либо недостающее требование окружения.

Границы проверки

Набор проверяет код модуля в тестовом окружении. Успешный запуск не подтверждает работу установленного модуля с реальной базой Битрикса, HTTP-обмен, браузерный CORS, производительность или ваши собственные контроллеры и интеграции.

Дополните его проверками своей бизнес-логики и проверкой API на тестовом сайте. Подробности устройства набора находятся в tests/README.md проверяемой версии модуля.