Nodemon — это служебная программа с интерфейсом командной строки, которая помогает создавать приложения Node.js путем динамического перезапуска приложения узла при обнаружении изменений файлов в каталоге.
В этой статье вы узнаете, как установить и настроить nodemon в соответствии с вашими конкретными потребностями, а также изучить распространенную ошибку, возникающую при использовании nodemon.
Почему вы должны использовать Nodemon
При разработке веб-серверов или серверных приложений вы обязаны изменить свой код для обработки ошибок и улучшения структуры и логики вашей программы.
Nodemon помогает, автоматически перезапуская сервер, когда вы вносите изменения в его код. Это помогает сэкономить время и упрощает отладку.
Как установить нодемон
Вы можете установить Nodemon либо локально как зависимость разработки, либо глобально по системному пути.
Чтобы установить nodemon глобально, выполните следующую команду npm в терминале вашего компьютера:
npm установить nodemon --globally
Чтобы установить nodemon локально, вы должны запустить следующую команду npm внутри каталога проекта в своем терминале:
npm установить nodemon --save-dev
Запуск Nodemon в приложении веб-сервера
Чтобы запустить nodemon и заставить его отслеживать ваше приложение веб-сервера, нужно выполнить несколько шагов. Блок кода ниже представляет собой базовый скрипт для сервера, который выводит на консоль строковое сообщение:
// app.js
константа экспресс = требовать('выражать');
константа приложение = экспресс();
приложение.слушай((5000), ()=>{
консоль.бревно(`Я изучаю нодмон`)
});
Чтобы начать просмотр этого скрипта, запустите команду nodemon, а затем имя файла, который он должен отслеживать:
приложение nodemon.js
Результирующий вывод должен включать что-то вроде следующего текста:
[nodemon] запуск `node app.js`
Я изучаю нодмон
После успешного запуска nodemon любые изменения в app.js файл приведет к перезагрузке всего серверного приложения.
Вы можете выйти из nodemon, нажав Ctrl + С в терминале вашего компьютера. Вы также можете перезапустить процесс nodemon вручную, введя рупий команда.
Использование Nodemon с параметрами командной строки
Nodemon имеет несколько параметров командной строки, которые можно использовать для изменения его поведения.
Чтобы просмотреть список всех доступных параметров nodemon и их функций, выполните следующую команду:
nodemon --help параметры
Среди многих доступных вариантов;
-
--задерживать: когда файл изменяется, nodemon по умолчанию ждет секунду перед перезапуском процесса. Вы можете указать другую задержку с помощью --задерживать выключатель. Вы можете выбрать время, в течение которого nodemon будет ждать перед перезапуском. Например:
nodemon --delay пять app.js
-
--игнорировать: опция переключателя игнорирования позволяет игнорировать определенные файлы в приложении веб-сервера. Вы можете использовать опцию переключения следующим образом:
nodemon --игнорировать lib/app.js
-
--смотреть: По умолчанию при запуске nodemon отслеживает текущий рабочий каталог. Чтобы взять под контроль эту опцию, используйте --смотреть возможность добавить определенные пути к файлам и изменить отслеживаемый каталог. Например, мониторинг каталога сервера:
nodemon --наблюдать за сервером
-
--exec: хотя это утилита JavaScript, вы также можете использовать Nodemon для просмотра файлов, отличных от JavaScript, таких как TypeScript, Python и Golang. Вы можете использовать --исполнитель возможность получить функцию автоматической перезагрузки nodemon в таких сценариях. Например, используя nodemon в скрипте TypeScript:
nodemon --exec ts-узел
-
--ext: Nodemon по умолчанию ищет файлы с расширениями JavaScript, TypeScript, CoffeeScript и JSON. Это потому что Проекты Node.js могут работать с TypeScript и файлы CoffeeScript, которые перед выполнением компилируются в чистый JavaScript. С другой стороны, файлы JSON также отслеживаются, поскольку они часто используются для хранения метаданных для проектов Node.js. Вы можете использовать -е (или --доб.) выберите, чтобы указать разделенный запятыми список файлов для просмотра. Например, для мониторинга файлов с расширениями .js, .json, и .mjs:
nodemon --ext js, json, mjs
Использование файлов конфигурации Nodemon
Nodemon поддерживает локальные и глобальные файлы конфигурации. Вы можете найти их в своем домашнем каталоге или в корневом каталоге проекта; их обычно называют nodemon.json файлы. Таким образом, вы можете сохранить свои конфигурации nodemon и легко использовать их в других проектах.
Параметры командной строки всегда переопределяют параметры файла конфигурации. Рабочий порядок приоритетов включает параметры командной строки, локальные файлы и файлы конфигурации.
Файл конфигурации может использовать любой параметр командной строки в качестве значения ключа JSON.
Например:
{
"смотреть": [ "сервер" ],
"добавочный": [ "JS", "тс", "жсон" ],
"задерживать": "5000",
"игнорировать": [ "lib/app.js" ]
}
В приведенном выше nodemon.json файл, nodemon настроен на просмотр сервер каталог, укажите файлы с .js, .тс, и .json продления, задержка на 5 секунд перед перезапуском после изменения файла и, наконец, игнорировать изменения файла в библиотека/приложение.js.
В качестве альтернативы nodemon поддерживает использование пакет.json для конфигурации, если вы храните все конфигурации пакетов в одном месте. Под nodemonconfig в файле package.json укажите конфигурацию в том же формате, что и для файла конфигурации.
Например, этот файл package.json включает ту же конфигурацию, что и файл nodemon.json выше:
{
"имя": "узел",
"версия": "",
"описание": "",
"нодемонконфиг": {
"смотреть": [
"сервер"
],
"добавочный": [ "JS", "тс", "жсон" ],
"задерживать": "5",
"игнорировать": [
"lib/app.js"
]
}
}
Обработка ошибок Nodemon
Пока вы разрабатываете свое приложение, вам нужно обрабатывать ошибки в JavaScripт по пути. Чтобы справиться с этими ошибками, вам сначала нужно знать, почему они происходят.
Вот распространенная ошибка, с которой вы можете столкнуться при работе с nodemon:
Сбой приложения [nodemon] — ожидание изменений файла перед запуском...
Существует несколько причин, по которым может появиться это сообщение об ошибке, и несколько способов их устранения.
- Неправильный синтаксис JavaScript в файлах, которые просматривает nodemon. Чтобы предотвратить эту ошибку, просмотрите свой код JavaScript, чтобы выявить в нем любые синтаксические ошибки.
- Запуск нескольких задач в фоновом режиме может помешать этой конкретной задаче. Попробуйте остановить все фоновые процессы и снова запустить программу, чтобы исправить это.
- Неправильная организация каталогов также может вызвать проблемы. Например, если файлы app.js и package.json не находятся в одном каталоге. Убедитесь, что вы правильно структурировали свой каталог, чтобы он не влиял на работу ваших программ.
Знакомство с Nodemon
Вы увидели полезность nodemon и то, как он может улучшить рабочий процесс, уменьшить количество ошибок и сделать отладку быстрее и проще.
Однако при работе с nodemon все еще могут возникать ошибки. Разработчику важно научиться устранять эти ошибки.