mitmario.dev

fetch

JavaScript Im Browser 4 Min Lesezeit 3 BeispieleLektion 2 von 7

Auf dem Server liegt eine Kursliste, und die Seite soll sie anzeigen, ohne dass sie in der eigenen Datei steht. Dafür gibt es die eingebaute Funktion fetch. Sie schickt eine Anfrage an eine Adresse und liefert ein Promise. Alles, was du in Abschnitt 15 über Promises gelernt hast, gilt hier eins zu eins.

Zwei await

Zwei await, nicht eins
async function holen() {
  // Erstes await: die Antwort ist da.
  const antwort = await fetch("/lernen/api/kurse.json");

  // Zweites await: der Inhalt ist gelesen und ausgepackt.
  const daten = await antwort.json();

  console.log("Typ:", typeof daten, "Anzahl:", daten.length);
  console.log("Erster Eintrag:", JSON.stringify(daten[0]));

  // Jeder Eintrag ist ein Objekt, die beiden Eigenschaften holt
  // Destructuring gleich im Schleifenkopf heraus.
  for (const { titel, stunden } of daten) {
    console.log(titel, "hat", stunden, "Stunden");
  }
}

holen();

fetch gibt eine Antwort zurück. Die Daten sind das noch nicht.

Das erste await wartet darauf, dass der Server geantwortet hat. Zu diesem Zeitpunkt sind der Status und die Kopfzeilen (im Code headers) da, aber der Inhalt ist noch nicht unbedingt vollständig gelesen.

Das zweite await liest den Inhalt und packt ihn aus. antwort.json() liest den Rumpf der Antwort (im Code body) zu Ende und schickt ihn durch JSON.parse, und weil auch das dauert, ist auch das ein Promise.

Im Reiter „Netzwerk“ kannst du das mitlesen. Nach dem Lauf steht dort eine Zeile für kurse.json, mit Status 200 und einer Dauer von ein paar Millisekunden. Nachgebaut ist da nichts, die Anfrage wurde wirklich abgeschickt.

Wenn du die Zeile aufklappst, siehst du, was die beiden await zurückgegeben haben. Oben stehen die Antwort-Kopfzeilen, darunter der Antwort-Rumpf.

Bei den Kopfzeilen steht content-type: application/json; charset=utf-8, derselbe Wert, den antwort.headers.get("content-type") liefert. antwort.json() schaut übrigens nicht darauf und schickt den Rumpf in jedem Fall durch JSON.parse, auch wenn dort text/plain steht.

Der Rumpf ist der Text, den der Server geschickt hat. Der Übungsserver schickt ihn schon eingerückt, so wie JSON.stringify(daten, null, 2) ihn schreiben würde. Viele Server schicken alles in einer Zeile, und dann wird es in der Anzeige eingerückt. Mit dem Button „Roh“ siehst du, was wirklich kam. Ganz unten steht ein curl-Befehl, mit dem du dieselbe Anfrage in einem Terminal wiederholen könntest.

Die drei Zeilen darüber sind etwas anderes, denn sie tragen die Marke „aus der Aufgabe“. index.html, styles.css und app.js liegen hier nicht auf einem Server, sie werden direkt in die Seite eingebaut. Über das Netz ging davon nichts, und deshalb steht das dabei, statt so zu tun, als hätte es eine Anfrage gegeben.

Was sonst noch in der Antwort steckt

Was in der Antwort steckt
async function ansehen() {
  const antwort = await fetch("/lernen/api/kurs.json");

  console.log("ok:", antwort.ok);
  console.log("status:", antwort.status);
  console.log("Inhaltstyp:", antwort.headers.get("content-type"));

  // text() liefert den rohen Text, so wie er über die Leitung kam.
  const roh = await antwort.text();
  console.log("Zeichen insgesamt:", roh.length);
  console.log("Anfang:", roh.slice(0, 40));

  // Der Rumpf lässt sich nur einmal lesen.
  try {
    await antwort.json();
  } catch (fehler) {
    console.warn("Zweites Lesen scheitert:", fehler.message);
  }
}

ansehen();

antwort.json() ist der häufigste Fall, aber nicht der einzige.

  • antwort.text() gibt den rohen Text, ohne ihn zu deuten, nützlich für alles, was kein JSON ist, und zum Nachsehen, wenn json() sich beschwert.
  • antwort.status ist die Zahl, die der Server zurückgemeldet hat, und antwort.ok sagt kurz, ob sie im guten Bereich liegt. Was das genau heißt, zeigt die nächste Lektion.
  • antwort.headers.get("content-type") liest eine Kopfzeile.

Im zweiten Beispiel steckt eine Eigenheit. Der Rumpf lässt sich nur einmal lesen. Nach text() scheitert json() mit TypeError: Failed to execute 'json' on 'Response': body stream already read, in Firefox mit TypeError: Response.json: Body has already been consumed. Brauchst du beides, liest du den Text und rufst JSON.parse selbst auf.

Was in der Adresse steht

Eine Adresse kann vollständig sein, mit https:// und Servernamen. Oder sie beginnt mit einem Schrägstrich und meint dann denselben Server, von dem die Seite kam. /lernen/api/kurse.json ist so ein Fall.

fetch schickt standardmäßig eine GET-Anfrage, also die Frage nach etwas. Wie man stattdessen etwas hinschickt, kommt in Lektion 16.5.

Ein Server muss übrigens nicht jeder Seite antworten. Fragt eine Seite bei einem fremden Server nach, entscheidet dessen Antwort darüber, ob der eigene Code sie sehen darf. Das Stichwort dazu ist CORS.

Wenn nichts ankommt

Wenn Daten nicht ankommen, schaust du am besten zuerst in den Reiter „Netzwerk“. Dort siehst du, was du sonst raten müsstest, nämlich ob die Anfrage überhaupt rausgegangen ist und was zurückkam.

Drei Fälle sehen dort völlig verschieden aus, und zwei davon kommen in den nächsten beiden Lektionen. Steht eine Anfrage gar nicht in der Liste, hat der eigene Code sie nie abgeschickt, und gesucht wird im Code. Hat sie einen Status ab 400, ist sie angekommen, und der Server sagt nur nein. Heißt sie fehlgeschlagen und hat gar keinen Status, kam sie nie bei einem Server an.

Denselben Reiter haben auch die Entwicklerwerkzeuge des Browsers. Sie gehen mit F12 auf, und der Reiter heißt dort ebenfalls Netzwerk, mit denselben Angaben und derselben Arbeitsweise, nur eben für jede Seite im Netz und nicht nur für die Seite im Reiter „Browser“.

Das vergessene zweite await

Das vergessene zweite await
async function falsch() {
  const daten = await fetch("/lernen/api/kurse.json");

  // Sieht aus wie die Liste, ist aber die Antwort.
  console.log("Länge:", daten.length);
  console.log("Erster Titel:", daten[0]);
  console.log("Ist es ein Array?", Array.isArray(daten));
}

async function richtig() {
  const antwort = await fetch("/lernen/api/kurse.json");
  const daten = await antwort.json();

  console.log("Länge:", daten.length);
  console.log("Erster Titel:", daten[0].titel);
  console.log("Ist es ein Array?", Array.isArray(daten));
}

falsch().then(richtig);

Das ist das Gegenstück zum vergessenen await aus Abschnitt 15, und es sieht genauso harmlos aus.

Mit nur einem await steht die Antwort in der Variablen und nicht die Daten. Eine Antwort ist aber auch ein Objekt, also wirft nichts. daten.length ist undefined, daten[0] auch, und Array.isArray sagt false. Wenn eine geladene Liste unerklärlich leer wirkt, fehlt meistens das zweite await.

In der Aufgabe kommen die Daten zum ersten Mal aus dem Netz, und drei Funktionen holen und zählen sie.

Zum Mitnehmen

fetch liefert zuerst eine Antwort und erst mit json den Inhalt, deshalb stehen dort zwei await. Was rausging und zurückkam, zeigt der Reiter Netzwerk, und ein fehlendes zweites await wirft nicht.

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.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.