Abschnitt 5 · Lektion 2
Pakete installieren
Aus „Grüße aus Köln“ eine Adresse wie gruesse-aus-koeln zu machen, sieht nach ein paar Zeilen aus.
Mit ü, ö, ß und dem ersten & in einem Titel werden es schnell mehr. Dafür gibt es fertige
Pakete, und mit dem ersten davon kommt fremder Code ins Projekt.
Was ein npm install anrichtet
Der Befehl dafür heißt npm install slugify. Danach sind drei Dinge anders. In der package.json
steht ein neuer Eintrag unter dependencies. Im Ordner node_modules liegt das Paket samt allem,
was es selbst braucht. Und in der package-lock.json, kurz Lockfile, steht, welche Version genau
geholt wurde, mitsamt ihrem Hash.
{
"name": "titel-werkzeug",
"version": "1.0.0",
"type": "module",
"private": true,
"dependencies": {
"slugify": "^1.6.9"
},
"devDependencies": {
"vitest": "^4.1.10"
}
} Zwei der drei Dinge gehören ins Repository, node_modules nicht. Warum, steht in Lektion 5.4.
In der Sandbox sieht das anders aus. Sie hat kein Netz. Die beiden Pakete, die dieser Kurs benutzt,
liegen deshalb schon bereit und werden nur nach node_modules kopiert statt geholt. Von den drei
Dingen oben passiert hier also nur eines. Das Paket liegt da, in deiner package.json steht nichts
davon, und eine package-lock.json gibt es gar nicht.
Nachsehen kannst du das im Terminal der Aufgabe, die Befehle dafür stehen in ihrer Befehlsleiste.
ls node_modules zeigt slugify, und npm ls nennt dasselbe Paket extraneous, weil die
package.json es nicht verlangt. Auf deinem Rechner schriebe npm install slugify den fehlenden
Eintrag mit hinein. Wie npm dorthin kommt, steht in der Lektion „Node auf deinem Rechner“ in
Abschnitt 4.
Ein anderes Paket holen geht hier nicht. npm install lodash --fetch-retries=0 endet mit
npm error code EAI_AGAIN, und das ist dieselbe Ursache wie bei jedem anderen Zugriff nach draußen.
Ohne --fetch-retries=0 versucht npm es noch zweimal, und das dauert länger als die 30 Sekunden,
die das Terminal einem Befehl lässt.
Die zwei Listen
Im Beispiel stehen zwei Blöcke. Wohin ein Paket gehört, hängt an einer einzigen Frage: Braucht es der laufende Code oder nur du beim Entwickeln?
slugify wird zur Laufzeit importiert. Ohne das Paket läuft dein Programm nicht. Also
dependencies.
vitest führt deine Tests aus. Auf dem Server läuft es nie. Also devDependencies, und das
schreibst du mit npm install --save-dev vitest oder kurz npm i -D vitest.
In die zweite Liste gehört alles, was nur beim Entwickeln läuft: ein Testwerkzeug, ein Linter oder
ein Bundler. Was in einem import deines Programms auftaucht, gehört in die erste.
Auf dem Server zählt nur die erste Liste
Auf deinem Rechner merkst du keinen Unterschied, denn npm install holt beide Listen.
Auf einem Server läuft dagegen meist npm ci --omit=dev. Das lädt nur die dependencies.
Testwerkzeuge braucht dort keiner, also wandern sie gar nicht erst über die Leitung. Das spart Zeit
bei jedem Deployment und macht die Angriffsfläche kleiner, denn jedes Paket auf dem Server ist Code,
der dort laufen kann.
Steht ein Paket in der falschen Liste, fehlt es auf dem Server. Beim Installieren fällt das noch
nicht auf, erst beim ersten Start, mit einem ERR_MODULE_NOT_FOUND für ein Paket, das auf deinem
Rechner seit Wochen da ist.
Ein Paket benutzen heißt, seine Dokumentation lesen
import slugify from "slugify";
const titel = "Grüße aus Köln";
console.log("Ohne Optionen:", slugify(titel));
console.log("Klein: ", slugify(titel, { lower: true }));
console.log("Mit locale de:", slugify(titel, { locale: "de" })); Dasselbe Paket macht aus demselben Titel drei verschiedene Kurzformen.
Ohne Optionen bleibt die Großschreibung stehen. Mit lower: true wird alles klein. Und aus dem ü
wird in beiden Fällen ein schlichtes u. Klein geschrieben steht da grusse-aus-koln.
Für einen deutschen Text ist das falsch. Im Deutschen wird ü zu ue und ö zu oe, und dafür
gibt es locale: "de". Erst damit kommt Gruesse-aus-Koeln heraus. Nebenbei wird aus dem & dann
auch ein und statt eines and.
Die Vorgabe eines Pakets ist die Einstellung, die seinem Autor am sinnvollsten schien, und der schreibt selten auf Deutsch. Mit zwei Minuten in der README hättest du das gewusst. Ohne sie stehen später ein paar tausend falsche Adressen in deiner Datenbank.
npx, wenn du es nur einmal brauchst
Manche Werkzeuge willst du benutzen, aber nicht aufnehmen, etwa um ein Projektgerüst zu erzeugen
oder einmal eine Datei umzuwandeln. npx <werkzeug> holt das Paket, führt es aus und nimmt es nicht
in dein Projekt auf.
Dafür muss es das Paket aus dem Netz holen. In der Sandbox hängt ein getipptes npx deshalb genauso
wie ein npm install ohne --fetch-retries=0, bis das Terminal den Befehl abbricht.
Was du dir mit npx holst, hat außerdem niemand angeschaut. Der Moment, in dem du sonst einen Blick
auf das Paket wirfst, fällt einfach weg. Wie dieser Blick aussieht, steht in Lektion 5.5.
Die Aufgabe macht aus drei Titeln Kurzformen, mit dem slugify, das in der Sandbox schon
bereitliegt.
Zum Mitnehmen
npm install trägt ein Paket in die package.json ein, legt es nach node_modules und hält die genaue Version im Lockfile fest. Was dein Programm importiert, gehört in dependencies, denn auf dem Server installiert npm ci --omit=dev nur diese Liste.
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 2 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.