Nodemon е помощна програма за интерфейс на командния ред, която помага при изграждането на приложения Node.js чрез динамично рестартиране на приложението за възел, когато идентифицира файлови промени в директорията.
Тази статия ще ви научи как да инсталирате и конфигурирате nodemon, за да отговаря на вашите конкретни нужди, както и ще проучи често срещана грешка, която възниква при използване на nodemon
Защо трябва да използвате Nodemon
Когато разработвате уеб сървъри или бекенд приложения, вие сте длъжни да промените кода си, за да обработвате грешки и да подобрявате структурата и логиката на вашата програма.
Nodemon помага чрез автоматично рестартиране на сървър, когато правите промени в неговия код. Това помага за спестяване на време и позволява по-лесно отстраняване на грешки.
Как да инсталирате Nodemon
Можете да инсталирате Nodemon или локално като зависимост за разработка, или глобално по системния път.
За да инсталирате nodemon глобално, изпълнете следната команда npm в терминала на вашия компютър:
npm инсталирайте nodemon --глобално
За да инсталирате nodemon локално, трябва да изпълните следната команда npm в директорията на вашия проект във вашия терминал:
npm инсталирайте nodemon --save-dev
Стартиране на Nodemon във вашето уеб сървърно приложение
Стартирането на nodemon и насочването му да наблюдава вашето уеб сървърно приложение включва няколко стъпки. Кодовият блок по-долу е основен скрипт за сървър, който записва низово съобщение в конзолата:
// app.js
конст експрес = изискват("експресен");
конст приложение = експрес();
app.listen((5000), ()=>{
конзола.log(„Научавам за nodemon“.)
});
За да започнете да гледате този скрипт, изпълнете командата nodemon, последвана от името на файла, който трябва да гледа:
nodemon app.js
Полученият резултат трябва да включва нещо като следния текст:
[nodemon] стартиране на `node app.js`
Научавам за nodemon
След като nodemon стартира успешно, всички промени в app.js файл ще предизвика презареждане на цялото сървърно приложение.
Можете да излезете от nodemon, като натиснете Ctrl + C в терминала на вашия компютър. Можете също така да рестартирате процеса nodemon ръчно, като въведете rs команда.
Използване на Nodemon с опции на командния ред
Nodemon има няколко опции на командния ред, които можете да използвате, за да промените поведението му.
За да видите списък с всички налични опции на nodemon и техните функции, изпълнете тази команда:
nodemon --помощни опции
Сред многото налични опции са;
-
--закъснение: Когато файл се промени, nodemon изчаква секунда по подразбиране, преди да рестартира процеса. Можете да зададете различно забавяне с --забавяне превключвател. Можете да изберете времето, което nodemon ще чака преди рестартиране. Например:
nodemon --delay пет app.js
-
--игнорирай: Опцията за превключване на игнориране ви позволява да игнорирате конкретни файлове в приложението на вашия уеб сървър. Можете да използвате опцията за превключване по следния начин:
nodemon --ignore lib/app.js
-
--гледам: По подразбиране, когато работи, nodemon следи текущата работна директория. За да поемете контрола над тази опция, използвайте --гледам опция за добавяне на конкретни файлови пътища и промяна на директорията, която се наблюдава. Например, наблюдение на сървърна директория:
nodemon --watch сървър
-
--изп: Въпреки че е помощна програма на JavaScript, можете също да използвате Nodemon, за да гледате файлове, които не са JavaScript, като TypeScript, Python и Golang. Можете да използвате...изп опция за получаване на функцията за автоматично презареждане на nodemon в такива скриптове. Например, използване на nodemon в TypeScript скрипт:
nodemon --exec ts-възел
-
--доп: 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 ключ.
Например:
{
"гледам": [ "сървър" ],
"ext": [ "js", "ц", "json" ],
"закъснение": "5000",
"игнорирай": [ "lib/app.js" ]
}
В горното nodemon.json файл, nodemon е настроен да наблюдава сървър директория, посочете файлове с .js, .ts, и .json разширения, забавяне за 5 секунди преди рестартиране след промени във файла и накрая игнорирайте промените във файла lib/app.js.
Като алтернатива nodemon поддържа използването package.json за конфигурация, ако съхранявате всички конфигурации на пакети на едно място. Под nodemonConfig във файла package.json посочете конфигурацията в същия формат, както бихте направили за конфигурационен файл.
Например този файл package.json включва същата конфигурация като файла nodemon.json по-горе:
{
"име": "nodemon",
"версия": "",
"описание": "",
"nodemonConfig": {
"гледам": [
"сървър"
],
"ext": [ "js", "ц", "json" ],
"закъснение": "5",
"игнорирай": [
"lib/app.js"
]
}
}
Обработка на грешки на Nodemon
Докато разработвате приложението си, ще трябва обработва грешки в JavaScript по пътя. За да се справите с тези грешки, първо трябва да знаете защо се случват.
Ето често срещана грешка, на която можете да се натъкнете, когато работите с nodemon:
Приложението [nodemon] се срина - изчакване на промени във файла преди стартиране...
Има няколко причини, поради които може да се появи това съобщение за грешка, и няколко начина за отстраняване на причините.
- Грешен синтаксис на JavaScript във файловете, които nodemon гледа. За да предотвратите тази грешка, прегледайте вашия JavaScript код, за да идентифицирате всички синтактични грешки в него.
- Изпълнението на множество задачи във фонов режим може да попречи на тази конкретна задача. Опитайте да спрете всички фонови процеси и да стартирате програмата отново, за да коригирате това.
- Неправилната организация на директорията също може да причини проблеми. Например, липсата на файловете app.js и package.json в една и съща директория. Уверете се, че структурирате директорията си правилно, така че да не повлияе на работата на вашите програми.
Получаване на комфорт с Nodemon
Видяхте полезността на nodemon и как той може да създаде по-добър работен процес, да намали грешките и да направи отстраняването на грешки по-бързо и по-лесно.
Въпреки това все още могат да възникнат грешки при работа с nodemon. Като разработчик е важно да се научите как да отстранявате тези грешки.