Конфигурация запуска

Конфигурация настраивается в файле json и может иметь следующие параметры.

Основные параметры

Имя параметра	Тип	Значение по умолчанию	Описание
`filter`	`Object`	Object, смотрите ниже	Параметры фильтрации, поиска тестов
`reportFormat`	`String`	`"jUnit"`	Формат отчета о тестировании, возможные значения: `"jUnit"`, `"JSON"` , `"allure"`, `"ctrf"`
`reports`	`Array`	`[]`	Множественные отчеты. Элемент: объект `\{ "format": "jUnit\|allure\|ctrf\|...", "path"?: "..." }`. При отсутствии — используется `reportFormat`/`reportPath` (обратная совместимость)
`reportPath`	`String`	`""`	Путь к формируемому отчету, можно указать или каталог (в которому будет создан файл отчета) или путь к файлу
`closeAfterTests`	`Boolean`	`True`	Признак закрытия 1С:Предприятие по завершении тестирования
`showReport`	`Boolean`	`True`	Открыть форму отчета завершению тестирования
`logging`	`Object`	Object, смотрите ниже	Параметры логирования, подробнее ниже
`exitCode`	`String`	`""`	Путь к файлу, в который будет записан признак успешного выполнения (0 - успешно, 1 - есть ошибки)
`projectPath`	`String`	`""`	Путь к каталогу проекта, содержащему файлы для тестов
`workspacePath`	`String`	`""`	Базовый каталог для разрешения относительных путей. Имеет приоритет над `projectPath` при разрешении.
`rpc`	`Object`	Object, смотрите ниже	Параметры подключения к серверу внешнего управления, подробнее ниже

Переопределение через командную строку

Начиная с версии 25.09, YAxUnit поддерживает переопределение параметров конфигурации через командную строку запуска 1С:Предприятия. Это обеспечивает гибкость при настройке CI/CD и запуске тестов в различных окружениях.

Формат команды

Параметры передаются в формате ключ=значение, разделенные точкой с запятой, внутри параметра /C"RunUnitTests...".

/C"RunUnitTests[=путь_к_файлу.json|true];[параметр1]=[значение1];[параметр2]=[значение2]"

RunUnitTests: Обязательная часть. Может использоваться как флаг (RunUnitTests) или с указанием значения (RunUnitTests=...).
- Без значения: RunUnitTests эквивалентно RunUnitTests=true. Используются настройки по умолчанию с возможностью их переопределения.
- Со значением:
  - RunUnitTests=путь_к_файлу.json: Используется указанный конфигурационный файл.
  - RunUnitTests=true: Явное указание на использование настроек по умолчанию.
;[параметр]=[значение]: Необязательные пары для переопределения.

Приоритет параметров

Параметры применяются в следующем порядке (каждый последующий уровень переопределяет предыдущий):

Значения по умолчанию: Встроенные в YAxUnit.
Файл конфигурации *.json: Значения из указанного файла.
Параметры командной строки: Значения, переданные через /C"...".

Поддержка относительных путей

Относительные пути в параметрах, таких как reportPath, exitCode, logging.file и reports[].path, разрешаются относительно базового каталога.

Логика определения базового каталога (по приоритету):

workspacePath: Если указан, используется его значение.
projectPath: Если workspacePath не указан, используется значение projectPath.
Текущий каталог: Если оба вышеуказанных параметра не заданы (каталог, из которого было запущено 1С:Предприятие).

Параметры фильтрации

Имя параметра	Тип	Значение по умолчанию	Описание
`extensions`	`Array`	`["tests"]`	Список имен расширений, из которых грузятся тесты
`modules`	`Array`	`Null`	Список имен модулей, из которых грузятся тесты
`tests`	`Array`	`Null`	Список полных путей к исполняемым тестам (`[имя модуля.имя теста{.Имя контекста}]`)
`suites`	`Array`	`Null`	Список имен тестовых наборов, которые будут запускаться
`tags`	`Array`	`Null`	Список тегов, которые будут запускаться
`contexts`	`Array`	`Null`	Список имен контекстов исполнения, в которых будут запускаться тесты

Параметры логирования

Имя параметра	Тип	Значение по умолчанию	Описание
`file`	`String`	`""`	Путь к файлу лога
`enable`	`Boolean`	`Null`	Использование логирвания. Если не указан, зависит от параметра `file` и `console`, если установлены - вкл, если нет - выкл
`console`	`Boolean`	`false`	Вывод лога в stdout (консоль)
`level`	`String`	`"debug"`	Уровень детализации лога. Возможные значения: `"debug"`, `"info"`, `"warning"`, `"error"`

Параметры внешнего управления

Служебные параметры, для настройки взаимодействия YAxUnit и 1С:EDT.

Имя параметра	Тип	Значение по умолчанию	Описание
`enable`	`Boolean`	`false`	Использование внешнего управления
`transport`	`String`	`"ws"`	Используемый транспортный протокол
`port`	`Boolean`	`0`	Порт сервера
`key`	`String`	`""`	Ключ клиента, для рукопожатия

Примеры

Запустить тесты расположенные в модулях МодульТестов1, МодульТестов2, закрыть предприятие по завершении и сохранить отчет в формате junit

{
    "filter": {
        "modules": ["МодульТестов1", "МодульТестов2"]
    },
    "reportPath": "C:\\temp\\jUnit\\report.xml",
    "reportFormat": "jUnit",
    "closeAfterTests": true
}

Запустить все тесты из расширения YAXUNIT и сохранить отчет файл C:\temp\jUnit\report.xml, остальные параметры будут установлены по умолчанию
```
{
    "filter": {
        "extensions": ["YAXUNIT"]
    },
    "reportPath": "C:\\temp\\jUnit\\report.xml"
}
```

Запустить все тесты с выводом подробного лога в файл, сохранить отчет файл C:\temp\jUnit\report.xml

{
    "reportPath": "C:\\temp\\jUnit\\report.xml",
    "logging": {
        "file": "C:\\temp\\jUnit\\tests.log",
        "level": "debug"
    }
}

Сформировать два отчета: jUnit в файл и Allure в каталог

{
    "reports": [
        { "format": "jUnit", "path": "C:\\temp\\jUnit\\report.xml" },
        { "format": "allure", "path": "C:\\temp\\allure" }
    ]
}

Сформировать два отчета: jUnit в файл и ctrf в каталог

{
    "reports": [
        { "format": "jUnit", "path": "C:\\temp\\jUnit\\report.xml" },
        { "format": "ctrf", "path": "C:\\temp\\ctrf" }
    ]
}

Основные параметры​

Переопределение через командную строку​

Формат команды​

Приоритет параметров​

Поддержка относительных путей​

Параметры фильтрации​

Параметры логирования​

Параметры внешнего управления​

Примеры​