Abschnitt 2 · Lektion 1
CommonJS
Sobald ein Programm mehr als eine Handvoll Funktionen hat, willst du es auf mehrere Dateien
verteilen. Und eine Funktion, die zwei Programme brauchen, soll nicht zweimal dastehen. Im Browser
hängen mehrere <script>-Tags ihre Dateien in dieselbe Seite, und danach liegt alles im selben
Raum. In Node gibt es keine Seite. Hier holt sich jede Datei selbst, was sie braucht.
Es gibt dafür zwei Systeme. Das ältere heißt CommonJS und arbeitet mit require und
module.exports. Das neuere heißt ESM und kommt in der nächsten Lektion.
Warum der Kurs mit dem alten anfängt
CommonJS findest du in älteren Projekten, in alten Stack-Overflow-Antworten und in Anleitungen aus der Zeit vor ESM. Wer es nicht lesen kann, versteht einen großen Teil des vorhandenen Codes nicht.
Geschrieben wird in diesem Kurs ab der nächsten Lektion trotzdem ESM. Lesen wirst du CommonJS aber oft, denn viel Code, in dem man im Beruf landet, wurde vor Jahren angefangen.
Hergeben und holen
Eine Datei ist in Node erst einmal für sich. Was darin steht, sieht sonst niemand, auch keine Datei
im selben Ordner. Erst module.exports macht etwas nach außen sichtbar.
function verdoppeln(zahl) {
return zahl * 2;
}
const gruss = "Hallo aus mathe.js";
module.exports = { verdoppeln, gruss }; const mathe = require("./mathe.js");
console.log(mathe.gruss);
console.log(mathe.verdoppeln(21));
const { verdoppeln } = require("./mathe.js");
console.log(verdoppeln(5)); module.exports ist eine ganz normale Zuweisung. Du legst dort ab, was andere benutzen dürfen,
meistens ein Objekt mit mehreren Einträgen. Auf der anderen Seite steht require. Es gibt das
Objekt zurück, das die andere Datei abgelegt hat.
Ob du es als Ganzes entgegennimmst oder gleich auseinandernimmst, ist Geschmackssache. Im Beispiel kommt bei beiden Wegen dasselbe heraus.
Der Punkt vor dem Schrägstrich
require("./mathe.js") beginnt mit ./, und das heißt „im selben Ordner wie diese Datei“. Ohne
./ wäre mathe.js ein Paketname. Node würde dann in node_modules suchen und nicht neben der
Datei. Wo Node überall nachschaut, kommt später in diesem Abschnitt.
Die Dateiendung darfst du in CommonJS weglassen, require("./mathe") funktioniert genauso. Ich
schreibe sie trotzdem immer hin. In ESM ist sie Pflicht, und eine Gewohnheit strengt weniger an als
eine Ausnahme.
Die Kurzform exports
Neben module.exports gibt es die Kurzform exports.name = .... Sie tut dasselbe, solange du an
das vorhandene Objekt etwas anhängst. Belegst du exports dagegen komplett neu, passiert gar nichts
mehr.
exports.eins = "das kommt an";
// Das hier belegt nur die lokale Variable neu.
exports = { zwei: "das kommt nicht an" }; const falle = require("./falle.js");
console.log(falle);
console.log(falle.zwei); exports ist am Anfang nur eine zweite Variable, die auf dasselbe Objekt zeigt wie
module.exports. Hängst du etwas an das Objekt an, sehen es beide. Weist du exports etwas Neues
zu, zeigt sie woanders hin, und module.exports bleibt unbeeindruckt. Herausgegeben wird immer nur,
was in module.exports steht.
Für ein ganzes Objekt ist module.exports der sichere Weg, exports.name reicht für einzelne
Einträge.
require passiert sofort, und nur einmal
require ist synchron. Die andere Datei wird nicht irgendwann im Hintergrund geladen, sondern
Node führt sie auf der Stelle von oben bis unten aus und macht erst danach mit der nächsten Zeile
weiter. Alles, was dort auf oberster Ebene steht, passiert also in dem Moment, in dem du die Datei
einbindest.
Außerdem merkt Node sich das Ergebnis.
console.log("zaehler.js wird ausgeführt");
let stand = 0;
module.exports = {
hoch() {
stand += 1;
return stand;
},
}; const a = require("./zaehler.js");
const b = require("./zaehler.js");
console.log(a.hoch());
console.log(b.hoch());
console.log(a === b); Beim zweiten require derselben Datei läuft gar nichts mehr. Node gibt einfach noch einmal das
Objekt heraus, das es beim ersten Mal bekommen hat. Darum steht die Meldung aus zaehler.js nur
einmal da, und der Stand zählt über beide Variablen hinweg weiter.
Das ist selten ein Problem und oft sogar erwünscht. Eine Datenbankverbindung oder eine eingelesene Konfiguration soll es nur einmal geben, auch wenn zehn Dateien sie anfordern. Ein Modul, das beim Laden etwas verändert, tut das allerdings auch nur einmal und nicht bei jedem Aufruf.
In der Aufgabe liegt eine fertige Datei mit drei Dingen bereit, und deine holt sich zwei davon.
Zum Mitnehmen
module.exports legt ab, was eine Datei herausgibt, require holt es, mit ./ vor dem Pfad. Die Datei läuft dabei sofort und nur beim ersten Mal.
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, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.