Nodemon je nástroj rozhrania príkazového riadka, ktorý pomáha pri vytváraní aplikácií Node.js dynamickým reštartovaním aplikácie uzla, keď identifikuje zmeny súborov v adresári.
Tento článok vás naučí, ako nainštalovať a nakonfigurovať nodemon, aby vyhovoval vašim konkrétnym potrebám, a tiež preskúmať bežnú chybu, ktorá sa vyskytuje pri používaní nodemonu
Prečo by ste mali používať Nodemon
Pri vývoji webových serverov alebo backendových aplikácií ste povinní zmeniť svoj kód, aby ste zvládli chyby a zlepšili štruktúru a logiku svojho programu.
Nodemon pomáha automatickým reštartovaním servera, keď vykonáte zmeny v jeho kóde. To pomáha šetriť čas a umožňuje jednoduchšie ladenie.
Ako nainštalovať Nodemon
Nodemon môžete nainštalovať buď lokálne ako vývojovú závislosť, alebo globálne na systémovej ceste.
Ak chcete nainštalovať nodemon globálne, spustite nasledujúci príkaz npm v termináli vášho počítača:
npm install nodemon --globálne
Ak chcete nainštalovať nodemon lokálne, mali by ste spustiť nasledujúci príkaz npm v adresári projektu vo vašom termináli:
npm install nodemon --save-dev
Spustenie Nodemon vo vašej aplikácii webového servera
Spustenie nodemonu a jeho prinútenie sledovať vašu aplikáciu webového servera zahŕňa niekoľko krokov. Nižšie uvedený blok kódu je základným skriptom pre server, ktorý zaznamenáva reťazcovú správu do konzoly:
// app.js
konšt vyjadriť = vyžadovať('expresné');
konšt app = express();
app.listen((5000), ()=>{
konzoly.log("Učím sa o nodemone.")
});
Ak chcete začať sledovať tento skript, spustite príkaz nodemon nasledovaný názvom súboru, ktorý má sledovať:
nodemon app.js
Výsledný výstup by mal obsahovať niečo ako nasledujúci text:
[nodemon] začínajúci `node app.js`
Učím sa o nodemone
Po úspešnom spustení nodemonu sa všetky zmeny na app.js súbor spôsobí opätovné načítanie celej serverovej aplikácie.
Môžete ukončiť nodemon stlačením Ctrl + C v termináli vášho počítača. Proces uzla môžete reštartovať aj manuálne zadaním rs príkaz.
Používanie Nodemon s možnosťami príkazového riadka
Nodemon má niekoľko možností príkazového riadka, ktoré môžete použiť na úpravu jeho správania.
Ak chcete zobraziť zoznam všetkých dostupných možností uzla a ich funkcií, spustite tento príkaz:
nodemon --možnosti pomoci
Medzi mnohými dostupnými možnosťami sú;
-
-- meškanie: Keď sa súbor zmení, nodemon štandardne počká sekundu pred reštartovaním procesu. Môžete určiť iné oneskorenie pomocou --meškanie prepínač. Môžete vybrať dobu, počas ktorej bude uzol čakať pred reštartovaním. Napríklad:
nodemon --delay päť app.js
-
--ignorovať: Možnosť prepínania ignorovania vám umožňuje ignorovať konkrétne súbory vo vašej aplikácii webového servera. Môžete použiť možnosť prepínania takto:
nodemon --ignore lib/app.js
-
-- sledujte: Štandardne pri spustení nodemon monitoruje aktuálny pracovný adresár. Ak chcete prevziať kontrolu nad touto možnosťou, použite --sledovať možnosť pridať konkrétne cesty k súborom a zmeniť sledovaný adresár. Napríklad monitorovanie adresára servera:
nodemon --watch server
-
--exec: Aj keď je to pomôcka JavaScript, môžete tiež použiť Nodemon na sledovanie súborov bez JavaScriptu, ako sú TypeScript, Python a Golang. Môžete použiť --exec možnosť získať funkciu automatického opätovného načítania uzla v takýchto skriptoch. Napríklad použitie uzla v skripte TypeScript:
nodemon --exec ts-node
-
--ext: Nodemon v predvolenom nastavení vyhľadáva súbory s príponami JavaScript, TypeScript, CoffeeScript a JSON. To je preto, že Projekty Node.js môžu pracovať s TypeScriptom a súbory CoffeeScript, ktoré sa pred spustením skompilujú do čistého JavaScriptu. Na druhej strane sú súbory JSON tiež monitorované, pretože sa často používajú na ukladanie metadát pre projekty Node.js. Môžete použiť -e (alebo --ext) prepnite na určenie zoznamu súborov na sledovanie oddelených čiarkami. Napríklad na sledovanie súborov s príponami .js, .json, a .mjs:
nodemon --ext js, json, mjs
Používanie konfiguračných súborov uzla
Nodemon podporuje lokálne a globálne konfiguračné súbory. Môžete ich nájsť vo svojom domovskom adresári alebo v koreňovom adresári projektu; zvyčajne sa volajú nodemon.json súbory. Týmto spôsobom môžete uložiť svoje konfigurácie uzlov a jednoducho ich znova použiť s inými projektmi.
Možnosti príkazového riadka vždy prepíšu nastavenia konfiguračného súboru. Pracovné poradie priorít zahŕňa voľby príkazového riadka, lokálne a konfiguračné súbory.
Konfiguračný súbor môže ako hodnotu kľúča JSON použiť ľubovoľnú možnosť príkazového riadka.
Napríklad:
{
"sledovať": [ "server" ],
"ext": [ "js", "ts", "json" ],
"meškanie": "5000",
"ignorovať": [ "lib/app.js" ]
}
Vo vyššie uvedenom nodemon.json súbor, nodemon je nastavený tak, aby sledoval server adresár, zadajte súbory s .js, .ts, a .json predĺženia, meškanie za 5 sekúnd pred reštartovaním po zmenách súboru a nakoniec zmeny súboru ignorujte lib/app.js.
Ako alternatívu nodemon podporuje použitie package.json pre konfiguráciu, ak uchovávate všetky konfigurácie balíkov na jednom mieste. Pod nodemonConfig v súbore package.json zadajte konfiguráciu v rovnakom formáte ako v prípade konfiguračného súboru.
Napríklad tento súbor package.json obsahuje rovnakú konfiguráciu ako súbor nodemon.json vyššie:
{
"názov": "nodemon",
"verzia": "",
"popis": "",
"nodemonConfig": {
"sledovať": [
"server"
],
"ext": [ "js", "ts", "json" ],
"meškanie": "5",
"ignorovať": [
"lib/app.js"
]
}
}
Spracovanie chýb uzlov
Počas vývoja aplikácie budete musieť spracovávať chyby v JavaScript po ceste. Aby ste tieto chyby zvládli, musíte najprv vedieť, prečo k nim dochádza.
Tu je bežná chyba, s ktorou sa môžete stretnúť pri práci s nodemonom:
Aplikácia [nodemon] zlyhala - pred spustením sa čaká na zmeny súborov...
Existuje niekoľko dôvodov, prečo sa toto chybové hlásenie môže vyskytnúť, a niekoľko spôsobov, ako odstrániť príčiny.
- Nesprávna syntax JavaScriptu v súboroch, ktoré nodemon sleduje. Ak chcete zabrániť tejto chybe, prejdite si kód JavaScript a identifikujte v ňom všetky syntaktické chyby.
- Spustenie viacerých úloh na pozadí môže narušiť túto konkrétnu úlohu. Skúste zastaviť všetky procesy na pozadí a znova spustiť program, aby ste to vyriešili.
- Problémy môže spôsobiť aj nesprávna organizácia adresárov. Napríklad nemať súbory app.js a package.json v rovnakom adresári. Uistite sa, že ste správne štruktúrovali svoj adresár, aby to neovplyvnilo beh vašich programov.
Získajte pohodlie s Nodemonom
Videli ste užitočnosť nodemonu a ako môže vytvoriť lepší pracovný postup, znížiť chyby a urýchliť a zjednodušiť ladenie.
Pri práci s nodemonom sa však stále môžu vyskytnúť chyby. Ako vývojár je dôležité naučiť sa odstraňovať tieto chyby.