Nodemon to narzędzie interfejsu wiersza polecenia, które pomaga w tworzeniu aplikacji Node.js poprzez dynamiczne ponowne uruchamianie aplikacji węzła, gdy wykryje ona zmiany plików w katalogu.
W tym artykule dowiesz się, jak zainstalować i skonfigurować nodemon do własnych potrzeb, a także poznasz typowy błąd występujący podczas korzystania z nodemon
Dlaczego warto używać Nodemona
Tworząc serwery sieciowe lub aplikacje zaplecza, musisz zmienić swój kod, aby obsłużyć błędy oraz poprawić strukturę i logikę swojego programu.
Nodemon pomaga, automatycznie uruchamiając ponownie serwer po wprowadzeniu zmian w jego kodzie. Pomaga to zaoszczędzić czas i ułatwia debugowanie.
Jak zainstalować Nodemona
Możesz zainstalować Nodemon lokalnie jako zależność programistyczną lub globalnie w ścieżce systemowej.
Aby zainstalować nodemon globalnie, uruchom następujące polecenie npm w terminalu komputera:
npm zainstaluj nodemon --globalnie
Aby zainstalować nodemon lokalnie, powinieneś uruchomić następującą komendę npm w katalogu projektu w swoim terminalu:
npm install nodemon --save-dev
Uruchamianie Nodemona w Twojej aplikacji serwera WWW
Uruchomienie nodemona i sprawienie, by obserwował aplikację serwera WWW, obejmuje kilka kroków. Poniższy blok kodu jest podstawowym skryptem dla serwera, który rejestruje ciąg znaków w konsoli:
// aplikacja.js
konst ekspres = wymagać('wyrazić');
konst aplikacja = ekspres();
aplikacja.słuchaj((5000), ()=>{
konsola.dziennik(`Uczę się o nodemonie`)
});
Aby rozpocząć oglądanie tego skryptu, uruchom polecenie nodemon, a następnie nazwę pliku, który powinien obserwować:
aplikacja nodemon.js
Wynikowy wynik powinien zawierać coś w rodzaju następującego tekstu:
[nodemon] uruchamia `węzeł app.js`
Uczę się o nodemon
Po pomyślnym uruchomieniu nodemon wszelkie zmiany w pliku aplikacja.js plik spowoduje ponowne załadowanie całej aplikacji serwera.
Możesz wyjść z nodemon, naciskając Ctrl + C w terminalu twojego komputera. Możesz także ręcznie zrestartować proces nodemon, wprowadzając plik rs Komenda.
Używanie Nodemona z opcjami wiersza poleceń
Nodemon ma kilka opcji wiersza poleceń, których można użyć do modyfikacji jego zachowania.
Aby zobaczyć listę wszystkich dostępnych opcji nodemon i ich funkcji, uruchom to polecenie:
nodemon --opcje pomocy
Wśród wielu dostępnych opcji są;
-
--opóźnienie: Gdy plik ulegnie zmianie, nodemon domyślnie czeka sekundę przed ponownym uruchomieniem procesu. Możesz określić inne opóźnienie za pomocą --opóźnienie przełącznik. Możesz wybrać czas, przez jaki nodemon będzie czekał przed ponownym uruchomieniem. Na przykład:
nodemon --opóźnij pięć app.js
-
--ignorować: Opcja przełącznika ignorowania umożliwia ignorowanie określonych plików w aplikacji serwera WWW. Możesz użyć opcji przełączania w następujący sposób:
nodemon --ignore lib/app.js
-
--oglądać: Domyślnie podczas działania nodemon monitoruje bieżący katalog roboczy. Aby przejąć kontrolę nad tą opcją, użyj --oglądać możliwość dodania określonych ścieżek plików i zmiany obserwowanego katalogu. Na przykład monitorowanie katalogu serwera:
nodemon --obserwuj serwer
-
--wykon: Chociaż jest to narzędzie JavaScript, możesz także używać Nodemona do oglądania plików innych niż JavaScript, takich jak TypeScript, Python i Golang. Możesz użyć --egzekutor możliwość uzyskania funkcji automatycznego przeładowania nodemona w takich skryptach. Na przykład użycie nodemon w skrypcie TypeScript:
nodemon --exec ts-node
-
--wewn: Nodemon domyślnie wyszukuje pliki z rozszerzeniami JavaScript, TypeScript, CoffeeScript i JSON. To dlatego, że Projekty Node.js mogą współpracować z TypeScript i pliki CoffeeScript, które przed wykonaniem kompilują się w czysty JavaScript. Z drugiej strony pliki JSON są również monitorowane, ponieważ często służą do przechowywania metadanych dla projektów Node.js. Możesz użyć -mi (Lub --wew), aby określić rozdzielaną przecinkami listę plików do oglądania. Na przykład, aby monitorować pliki z rozszerzeniami .js, .json, I .mjs:
nodemon --ext js, json, mjs
Używanie plików konfiguracyjnych Nodemona
Nodemon obsługuje lokalne i globalne pliki konfiguracyjne. Możesz je znaleźć w swoim katalogu domowym lub katalogu głównym projektu; zwykle się nazywają nodemon.json akta. W ten sposób możesz zapisać konfiguracje nodemon i łatwo użyć ich ponownie w innych projektach.
Opcje wiersza poleceń zawsze zastąpią ustawienia pliku konfiguracyjnego. Kolejność priorytetów roboczych obejmuje opcje wiersza poleceń, pliki lokalne i konfiguracyjne.
Plik konfiguracyjny może używać dowolnej opcji wiersza poleceń jako wartości klucza JSON.
Na przykład:
{
"oglądać": [ "serwer" ],
„zew”: [ "js", "ts", "json" ],
"opóźnienie": "5000",
"ignorować": [ „lib/app.js” ]
}
W powyższym nodemon.json plik, nodemon jest ustawiony do oglądania serwer katalog, określ pliki za pomocą .js, ts, I .json rozszerzenia, opóźnienie dla 5 sekund przed ponownym uruchomieniem po zmianach plików, a na koniec zignoruj zmiany w plikach lib/app.js.
Alternatywnie, nodemon obsługuje używanie pakiet.json do konfiguracji, jeśli przechowujesz wszystkie konfiguracje pakietów w jednym miejscu. Pod nodemonConfig w pliku package.json określ konfigurację w takim samym formacie, jak w przypadku pliku konfiguracyjnego.
Na przykład ten plik package.json zawiera taką samą konfigurację jak powyższy plik nodemon.json:
{
"nazwa": „węzłowy demon”,
"wersja": "",
"opis": "",
„NodemonConfig”: {
"oglądać": [
"serwer"
],
„zew”: [ "js", "ts", "json" ],
"opóźnienie": "5",
"ignorować": [
„lib/app.js”
]
}
}
Obsługa błędów Nodemona
Podczas tworzenia aplikacji będziesz potrzebować obsługiwać błędy w JavaScript po drodze. Aby poradzić sobie z tymi błędami, musisz najpierw wiedzieć, dlaczego się zdarzają.
Oto typowy błąd, który możesz napotkać podczas pracy z nodemonem:
Awaria aplikacji [nodemon] — oczekiwanie na zmiany plików przed uruchomieniem...
Istnieje kilka powodów, dla których może wystąpić ten komunikat o błędzie, oraz kilka sposobów usunięcia przyczyn.
- Nieprawidłowa składnia JavaScript w plikach obserwowanych przez nodemon. Aby zapobiec temu błędowi, przejrzyj swój kod JavaScript, aby zidentyfikować występujące w nim błędy składniowe.
- Uruchamianie wielu zadań w tle może kolidować z tym konkretnym zadaniem. Spróbuj zatrzymać wszystkie procesy w tle i ponownie uruchomić program, aby rozwiązać ten problem.
- Niewłaściwa organizacja katalogów może również powodować problemy. Na przykład brak plików app.js i package.json w tym samym katalogu. Upewnij się, że masz odpowiednią strukturę katalogu, tak aby nie wpływał on na działanie twoich programów.
Przyzwyczajenie się do Nodemon
Widziałeś przydatność nodemon i sposób, w jaki może on stworzyć lepszy przepływ pracy, zmniejszyć liczbę błędów oraz przyspieszyć i ułatwić debugowanie.
Jednak podczas pracy z nodemonem nadal mogą wystąpić błędy. Jako programista ważne jest, aby dowiedzieć się, jak rozwiązywać problemy z tymi błędami.