mitmario.dev

Die Sandbox in diesem Kurs

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

Ein fetch scheitert an der Namensauflösung. Ein Programm wird nach zehn Sekunden abgebrochen. Eine Eingabe ist zu Ende, bevor jemand tippen konnte. Im eigenen Code findest du dafür keine Ursache, denn es liegt an der Umgebung, in der er läuft.

Dein Code läuft in diesem Kurs in einer kleinen virtuellen Maschine in einem Rechenzentrum, nicht im Browser und nicht auf deinem Rechner. Diese Maschine hat ein paar Grenzen, die dein eigener Rechner nicht hat.

Was hier nicht geht

Die Maschine hat keinen Netzzugang, nicht einmal eine Namensauflösung.

Ein Zugriff nach draußen schlägt fehl
const antwort = await fetch("https://example.com/kurse.json");
console.log(await antwort.json());

Der Aufruf endet mit [TypeError: fetch failed]. Darunter steht als Ursache EAI_AGAIN, und das ist der Code dafür, dass sich example.com nicht auflösen ließ. Der Stacktrace dazu stammt ganz aus Node, eine Zeile mit deiner Datei kommt darin nicht vor. Schuld ist die fehlende Leitung nach draußen und nicht dein Code.

Auch beim Installieren gibt es keine Ausnahme. Die beiden Pakete, die der Kurs benutzt, liegen schon auf der Maschine und werden nur an die richtige Stelle kopiert. Tippst du npm install für irgendetwas anderes, versucht npm es dreimal und braucht dafür länger als die 30 Sekunden des Terminals. Mit --fetch-retries=0 dahinter kommt sofort dieselbe Ursache, nur aus npm, nämlich npm error code EAI_AGAIN.

Eine Tastatureingabe während des Laufs gibt es nicht. Hier sitzt ja niemand an der Tastatur, also bekommt ein Programm, das auf eine Eingabe wartet, sofort das Ende der Eingabe zu sehen. Text in ein Programm hineinleiten kannst du im Terminal trotzdem, und in Lektion 4.4 stehen beide Wege nebeneinander.

Ein Skript hat beim Prüfen und mit Sandbox starten höchstens zehn Sekunden, danach wird es hart beendet.

Eine Endlosschleife wird abgebrochen
console.log("Los");

let n = 0;
while (true) {
  n = n + 1;
}

Im Terminal steht das Los aus der ersten Zeile und darunter „Zeitlimit von 10 s erreicht, Prozess beendet.“ Dieser Satz kommt von der Umgebung und nicht von deinem Programm. Deshalb steht er auf dem Fehlerkanal. Hinter einem Zeitlimit steckt meistens eine Schleife ohne Ende, ein await auf etwas, das nie kommt, oder ein Server, der auf einem falschen Port hört. Ein Server bekommt beim Prüfen 25 Sekunden, ein getippter Befehl im Terminal 30.

Einen Exit-Code schreibt das Terminal nicht dazu. Jeder getippte Befehl läuft in einer eigenen Shell und weiß vom vorigen nichts mehr. Deshalb muss echo $? in dieselbe Zeile wie der Befehl, also node index.js; echo $?.

Prüfen fängt mit genau den Dateien an, die im Editor stehen. Was dein Programm beim letzten Mal angelegt hat, ist dann weg. Im Terminal wird dagegen nicht aufgeräumt. Was ein Befehl dort anlegt, bleibt liegen, bis Prüfen von vorn anfängt, ein anderes Beispiel nach vorn kommt oder die Sandbox endet. Wichtig wird das in Abschnitt 3, wenn du Dateien schreibst und danach nachsehen willst, ob sie wirklich da sind.

Was dafür geht

Alles, was den Kurs ausmacht. Echte Dateien, die du liest und schreibst, Module über mehrere Dateien, ein Server auf localhost, eine SQLite-Datenbank, und Express liegt schon auf der Maschine.

Nachgebildet ist dabei nichts. Was hier läuft, läuft auf deinem Rechner mit Node 24 genauso, und auch ein Stacktrace sieht dort gleich aus, nur eben mit deinem eigenen Ordner im Pfad. Wie du Node dort einrichtest, steht in Abschnitt 4.

Warum es so gebaut ist

Zwei Gründe, und beide sind langweilig und richtig.

Eine Umgebung ohne Netz lässt sich nicht für fremde Zwecke missbrauchen. Fremden Code auszuführen und ihn dann ins Internet zu lassen, wäre ein offenes Scheunentor.

Und Prüfen fängt jedes Mal sauber an, also hängt keine Aufgabe davon ab, was in der vorigen liegen geblieben ist. Sonst bestünde eine Aufgabe irgendwann nur deshalb, weil zwei Lektionen vorher zufällig die passende Datei entstanden ist.

Eine Ausgabe ist noch keine Seite

Was dein Programm schreibt, steht im Terminal, und was ein Server antwortet, im Reiter Browser. Solange kein Server läuft, bleibt der Browser weiß.

Eine Ausgabe, die eine Seite ist
const kurse = ["HTML", "CSS", "JavaScript", "Node.js"];

const zeilen = kurse.map((kurs) => `  <li>${kurs}</li>`).join("\n");

console.log(`<h1>Vier Kurse</h1>
<ul>
${zeilen}
</ul>`);

Hier wird Markup ausgegeben, und trotzdem passiert im Reiter Browser nichts. Im Terminal stehen die Zeichen, die dein Programm geschrieben hat, also <h1>Vier Kurse</h1> und die Liste. Der Browser bleibt weiß. Es läuft ja kein Server, und ohne Server ist niemand da, der diese Zeichen an einen Browser schicken würde.

Ab Abschnitt 8 schickt dein Server solches Markup über HTTP, und im Reiter Browser wird daraus eine Seite. Auf der lassen sich dann Links anklicken und Formulare abschicken. Mit laufender Sandbox zieht sie außerdem bei jeder Änderung an deinem Code nach.

Der Kostenteil, im Klartext

Eine solche Maschine kostet bei jedem Lauf Geld. Nicht viel, aber echtes Geld. In den Kursen davor lief dein Code im Browser, und der gehört dir.

Alles, was du liest, kostet nichts. Das sind die Texte der Lektionen, der Code aller Beispiele, die Aufgaben und die Abschnittstests. Sobald eine Maschine läuft, zählt ihre Laufzeit auf ein Kontingent, das jeden Nutzungsmonat neu beginnt, 1 Stunde mit dem Basis Konto und 60 Stunden mit dem Premium Konto. Wie viel davon übrig ist, steht in jeder Lektion mit Sandbox und unter „Nutzungsmonat“ in deinem Konto. Ist das Kontingent aufgebraucht, geht es im nächsten Nutzungsmonat weiter. Wer vom Basis Konto wechselt, macht mit dem Premium Konto sofort weiter.

Eine Maschine läuft nur, wenn du sie holst. Das passiert mit Sandbox starten, mit Prüfen, mit Aufzeichnen im Reiter Debug, mit Live oder mit einem Befehl im Terminal. In den Browser-Kursen lief deine Seite immer mit. Hier wäre das eine Maschine, die durchgehend läuft. Mit dem Premium Konto kommt sie schon beim ersten Tastendruck in einer Lektion, damit der erste Lauf nicht auf den Kaltstart warten muss.

Was dasteht, ist dafür wirklich gelaufen. Nachgestellte Ausgaben gibt es nicht und keine Zahlen, für die am Ende niemand geradesteht.

Zum Mitnehmen

Dein Code läuft hier in einer Maschine ohne Netz, mit einem Zeitlimit je Lauf und einem Kontingent je Nutzungsmonat. Prüfen fängt jedes Mal mit frischen Dateien an, das Terminal räumt nicht auf.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

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.