Abschnitt 2 · Lektion 5
Wie Node ein Modul findet
Cannot find module ist eine der ersten Fehlermeldungen, die dir in Node begegnen. Sie sagt dir,
dass etwas fehlt, und bei einem Pfad auch, wo Node nachgesehen hat. Warum dort nichts lag, hängt
daran, wie Node sucht.
Drei Arten von Angaben
Was zwischen den Anführungszeichen steht, nennt sich Spezifizierer (englisch specifier), hier kurz Angabe. Node schaut sich ihren Anfang an und entscheidet daran, wie gesucht wird:
- Fängt sie mit
./oder../an, ist sie ein Pfad. Gesucht wird relativ zu der Datei, in der der Import steht, und nicht relativ zum Arbeitsverzeichnis. Das ist derselbe Unterschied wie in der vorigen Lektion, nur nimmt Node ihn dir hier ab. - Fängt sie mit
node:an, ist das Modul eingebaut, und Node schaut gar nicht erst auf die Festplatte. - Alles andere ist ein Paket, außer der Name gehört einem älteren eingebauten Modul wie
fsoderpath. Die findet Node auch ohne Präfix, und zwar immer zuerst. Für einen Namen wieexpressoderslugifysucht Node dagegen innode_modules.
export function rechne(zahl) {
return zahl * zahl;
} import { readFile } from "node:fs/promises";
import { rechne } from "./lib/rechnen.mjs";
console.log("eingebaut:", typeof readFile);
console.log("relativ:", rechne(4)); Wie die Suche nach einem Paket abläuft
Bei einem Paketnamen schaut Node zuerst in das node_modules neben der Datei. Findet es dort
nichts, geht es einen Ordner nach oben und schaut wieder. Und noch einen. Und so weiter, bis zur
Wurzel des Dateisystems.
Deshalb findet eine Datei tief unten in src/routen/admin/ ein Paket, obwohl dort weit und breit
kein node_modules liegt. Es liegt oben im Projektstamm, und Node hat sich hochgearbeitet.
Für Pakete gibt es noch eine zweite Schicht. In der package.json eines Pakets kann ein Feld
"exports" stehen, und darin legt der Autor fest, welche Dateien von außen überhaupt erreichbar
sind und unter welchem Namen. Deshalb funktioniert import x from "paket/extra" bei manchen Paketen
und bei anderen nicht. Mehr brauchst du dazu vorerst nicht zu wissen.
Vier Ursachen
Die erste ist ein Tippfehler. In der Fehlermeldung steht Zeichen für Zeichen, wonach gesucht wurde, und neben dem echten Dateinamen fällt der Tippfehler meist sofort auf.
Die zweite ist die vergessene Dateiendung. In ESM ist sie Pflicht, und die Gewohnheit, sie wegzulassen, kommt aus Projekten mit Bundler.
export function rechne(zahl) {
return zahl * zahl;
} // Die Datei liegt in lib/, hier fehlt der Ordner im Pfad.
import { rechne } from "./rechnen.mjs";
console.log(rechne(4)); Im Beispiel stimmt die Endung, dafür fehlt der Ordner. In der Fehlermeldung steht trotzdem genau der Ort, an dem gesucht wurde, und da liegt eben nichts. Diese Zeile zu lesen geht schneller als raten.
Die dritte ist ein vergessenes npm install. Steht der Name ohne ./ da und meldet Node
Cannot find package, hat es in node_modules gesucht und nichts gefunden. Meistens ist das
Projekt frisch heruntergeladen und noch nicht installiert.
Die vierte ist die Groß- und Kleinschreibung, und sie kommt dich am teuersten zu stehen.
export function rechne(zahl) {
return zahl * zahl;
} // Die Datei heißt rechnen.mjs, hier steht Rechnen.mjs.
import { rechne } from "./lib/Rechnen.mjs";
console.log(rechne(4)); Auf macOS und unter Windows unterscheidet das Dateisystem meistens nicht zwischen Groß- und
Kleinschreibung. Rechnen.mjs findet dort also die Datei rechnen.mjs, und dein Programm läuft.
Linux unterscheidet sehr wohl, und auf Linux läuft dein Server. Heraus kommt ein Fehler, den es nur
in der Produktion gibt und den du lokal nicht nachstellen kannst.
Mit Dateinamen nur in Kleinbuchstaben und mit Bindestrichen gibt es nichts zu verwechseln.
In der Aufgabe reparierst du vier Importzeilen. Dabei läuft nichts, geprüft wird nur ihr Wortlaut.
Zum Mitnehmen
Mit ./ oder ../ sucht Node eine Datei relativ zu deiner, mit node: ein eingebautes Modul. Sonst nimmt es ein älteres eingebautes Modul gleichen Namens oder sucht ein Paket in node_modules, von der Datei aus aufwärts.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, auf dem Server geprüft
Öffnet sich mit dem Basis Konto.