mitmario.dev

Synthese: der Modul-Baukasten

Node.js Sandbox 3 Min Lesezeit 2 BeispieleLektion 6 von 7

Welche Dateien es überhaupt geben soll, entscheidest du selbst. Kein Sprachmittel nimmt dir das ab. Ein Programm lässt sich in zwei Dateien schneiden oder in zwanzig, und beides läuft. Ob der Schnitt falsch war, merkst du erst später, wenn eine kleine Änderung auf einmal drei Dateien braucht.

Eine Datei ist die Antwort auf eine Frage

Gemeint ist eine Frage, die sich in einem Satz stellen lässt. „Wie rechne ich Preise?“ ist so eine, „Wie formatiere ich Beträge und Tabellenzeilen?“ auch. Ein Thema reicht nicht.

Eine Datei, eine Frage
import { euro, tabelle } from "./format.mjs";

console.log(tabelle("Kaffee", euro(23.8)));
console.log(tabelle("Versand", euro(4.9)));

format.mjs beantwortet eine einzige Frage. Rechenlogik oder Dateizugriff stehen darin nicht. Beim nächsten Formatierungsproblem weißt du also sofort, wo du hinschauen musst. Und wer in einem halben Jahr die Währung wechseln will, weiß auch, wo er anfängt.

Lässt sich der Zweck einer Datei nur mit „und“ beschreiben, sind es zwei Dateien.

Warum utils.js ein Warnsignal ist

Viele Projekte haben irgendwann eine Datei namens utils.js, helpers.js oder common.js. Sie fängt mit zwei Funktionen an. Nach einem Jahr sind es vierzig.

Sie beantwortet keine Frage. Darin landet, was nirgends anders hinpasste. Das kann man von jeder neuen Funktion behaupten, und so wächst die Datei immer weiter. Am Ende importiert die halbe Anwendung dieselbe Datei, und keiner kann mehr sagen, wofür.

Verbieten muss man utils.js deshalb nicht. Es reicht, sich beim Hineinschreiben einer neuen Funktion kurz zu fragen, wozu sie eigentlich gehört, und meistens fällt einem dann auch gleich der richtige Name ein.

Wie ein Programm aus Bausteinen aussieht

Ein kleines Programm aus Bausteinen, wie das in der Aufgabe, hat oft diese Form. daten.mjs liefert, was es gibt. preise.mjs macht daraus Zahlen und texte.mjs daraus Ausgaben. index.mjs verdrahtet die drei.

Nur index.mjs kennt alle drei. Untereinander kennen sie sich nicht, und deshalb lassen sie sich austauschen. Die Daten könnten zum Beispiel aus einer Datei kommen statt aus einer Liste im Code, und texte.mjs würde davon nichts merken.

In Abschnitt 18 bekommt diese Aufteilung einen Namen und eine Ordnerstruktur.

Wenn zwei Dateien sich gegenseitig brauchen

Schiefgegangen ist der Schnitt, wenn a.mjs die Datei b.mjs importiert und b.mjs wiederum a.mjs.

Wenn zwei sich gegenseitig brauchen
import "./a.mjs";

Node arbeitet die Kette einmal ab und lässt den noch nicht fertigen Teil leer. In ESM merkst du das an einem ReferenceError, weil eine Konstante noch nicht bereitsteht. In CommonJS bekämst du an derselben Stelle ein halb gefülltes Objekt, und statt eines Fehlers stünde nur eine Warnung auf dem Fehlerkanal.

Steht in der Meldung Cannot access 'a' before initialization der Name eines importierten Werts, ist das ein ziemlich zuverlässiges Zeichen für einen Ringschluss (englisch circular dependency). Der Ausweg ist meistens ein Stück, das in beiden steckt. Das kommt in eine eigene Datei, und aus der bedienen sich dann beide.

In der Aufgabe sind drei Bausteine schon geschrieben, und eine leere index.mjs soll sie verdrahten.

Zum Mitnehmen

Jede Datei beantwortet eine Frage, und index.mjs verdrahtet die Antworten. Brauchen zwei Dateien einander, gehört das Gemeinsame meistens in eine dritte.

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 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.