Установка и настройка newman-reporter-allure на macOS с nvm

При автоматизации API-тестов с помощью Postman и Newman на macOS часто возникает необходимость генерации подробных отчётов. Allure - один из самых популярных инструментов для визуализации результатов тестирования. Однако при установке newman-reporter-allure пользователи, использующие менеджер версий Node.js (nvm), нередко сталкиваются с ошибками: newman: could not find "allure" reporter или EACCES при глобальной установке пакетов. В этой статье мы разберём причины этих проблем и предоставим рабочий пошаговый пример для macOS.

Почему возникает ошибка "could not find allure reporter"

Newman ищет репортеры в глобальной директории node_modules. Если вы установили newman-reporter-allure локально (в папке проекта), Newman не сможет его найти при запуске из другого места. Также использование nvm создаёт изолированные окружения для каждой версии Node.js, что может привести к путанице с глобальными путями. Ошибка EACCES обычно возникает при попытке установки глобального пакета без прав суперпользователя.

Пошаговая инструкция для macOS с nvm

Шаг 1: Проверьте установку nvm и Node.js

Убедитесь, что nvm установлен и активна нужная версия Node.js. Выполните в терминале:

nvm --version
node --version
npm --version

Если nvm не установлен, скачайте его с официального репозитория.

Шаг 2: Установите newman глобально через nvm

Глобальная установка newman через nvm не требует прав sudo, так как nvm использует домашнюю директорию пользователя. Выполните:

npm install -g newman

Шаг 3: Установите newman-reporter-allure глобально

Чтобы избежать ошибки "could not find allure reporter", установите репортер также глобально:

npm install -g newman-reporter-allure

После установки проверьте, что пакет появился в глобальной папке nvm:

ls $(npm root -g) | grep allure

Шаг 4: Запустите Newman с репортером Allure

Теперь запустите тесты, указав репортер allure:

newman run your_collection.json -r allure

После выполнения в текущей директории появится папка allure-results с данными для отчёта.

Шаг 5: Сгенерируйте и откройте Allure отчёт

Для генерации HTML-отчёта установите утилиту Allure (если ещё не установлена):

brew install allure

Затем выполните команду для создания и открытия отчёта:

allure generate allure-results --clean -o allure-report
allure open allure-report

Откроется браузер с интерактивным отчётом, содержащим статистику прохождения тестов, временные метрики и вложения.

Решение проблемы EACCES при глобальной установке

Если вы всё же получили ошибку EACCES, это означает, что npm пытается записать файлы в системную директорию. При использовании nvm этого не должно происходить, но если ошибка возникла, проверьте права на папку npm:

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Либо перенастройте npm на использование пользовательской директории:

npm config set prefix ~/.npm-global

После этого добавьте ~/.npm-global/bin в переменную PATH.

Альтернативный способ: локальная установка с указанием пути

Если вы предпочитаете локальную установку, установите newman и репортер в папку проекта:

npm init -y
npm install newman newman-reporter-allure

Затем запускайте Newman через npx:

npx newman run collection.json -r allure

Этот метод гарантирует, что репортер будет найден, так как npx ищет пакеты в локальной папке node_modules.

Заключение

Настройка newman-reporter-allure на macOS с nvm не представляет сложности, если следовать правильному порядку. Главное - устанавливать репортер глобально через nvm или использовать npx для локальных пакетов. Это позволит избежать ошибок поиска репортера и проблем с правами доступа. После прогона тестов сгенерируйте отчёт Allure и анализируйте результаты в удобном интерфейсе.