mitmario.dev

Wie Node ein Modul findet

Node.js Sandbox 3 Min Lesezeit 3 BeispieleLektion 5 von 7

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 fs oder path. Die findet Node auch ohne Präfix, und zwar immer zuerst. Für einen Namen wie express oder slugify sucht Node dagegen in node_modules.
Drei Arten von Angaben
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.

Ein Pfad, der nicht stimmt
// 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.

Groß und klein ist nicht dasselbe
// 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, kostenlos

Zu 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.