mitmario.dev

Text ändern

JavaScript Im Browser 3 Min Lesezeit 3 BeispieleLektion 1 von 9

Über der Trefferliste steht, wonach gesucht wurde. Und dann tippt jemand statt eines Wortes ein Stück Markup ins Suchfeld. Je nachdem, wie der Text auf die Seite kommt, steht dort sichtbar dieses Markup, oder es läuft Code, den niemand von der Seite geschrieben hat. Den Text eines Elements auszutauschen ist der einfachste Schreibzugriff überhaupt, und schon hier fällt diese Entscheidung.

textContent ersetzt alles

Text ersetzen mit textContent
document.getElementById("titel").textContent = "Neuer Titel";

// Das ersetzt den ganzen Inhalt, auch das <strong>.
const satz = document.getElementById("satz");
satz.textContent = "Jetzt steht hier etwas anderes.";
console.log("noch ein strong da?", satz.querySelector("strong"));

// Was kein Text ist, wird zu Text gemacht.
document.getElementById("zahl").textContent = 42;
console.log("Typ im Element:", typeof document.getElementById("zahl").textContent);

el.textContent = "Neuer Titel" setzt den Inhalt des Elements auf genau diesen Text. Ersetzt heißt dabei wirklich ersetzt. Alles, was vorher drinstand, ist danach weg, auch untergeordnete Elemente, und deshalb überlebt das <strong> im zweiten Absatz des Beispiels die Zuweisung nicht.

Zuweisen kannst du auch etwas anderes als Text. Eine Zahl wird umgewandelt, aus 42 wird der Text "42". Was danach im Element steht, ist immer Text, auch wenn eine Zahl hineingeschrieben wurde. In Abschnitt 12 wird das wichtig.

Markup entsteht mit textContent nie, auch nicht aus Versehen. Das ist seine Stärke.

Nachprüfen kannst du das in der Eingabezeile der Console. satz.querySelector("strong") antwortet mit null, das Element ist weg. Und typeof document.getElementById("zahl").textContent antwortet mit "string", obwohl die Zeile im Beispiel eine Zahl zugewiesen hat.

innerHTML baut Elemente

Markup einsetzen mit innerHTML
// innerHTML erwartet Markup und baut daraus wirklich Elemente.
document.getElementById("liste").innerHTML = `
  <li>HTML</li>
  <li>CSS</li>
`;
console.log("Einträge:", document.querySelectorAll("#liste li").length);

// Derselbe Text mit textContent bleibt einfach Text.
document.getElementById("mit-text").textContent = "<li>HTML</li>";
console.log("Elemente daraus:", document.querySelectorAll("#mit-text li").length);

el.innerHTML = "<li>HTML</li>" liest den Text als Markup, baut daraus Elemente und hängt sie ein. Im Beispiel stehen danach wirklich zwei li da. querySelectorAll findet sie, und sie verhalten sich wie jedes andere Element auf der Seite.

Setzt du denselben Text mit textContent, bleibt er Text. Auf dem Bildschirm steht dann sichtbar <li>HTML</li>, und querySelectorAll findet nichts. Der eine Weg zeigt den Text an. Der andere baut etwas daraus.

Fremder Text in innerHTML

Warum fremder Text nicht nach innerHTML gehört
// Angenommen, das kommt aus einem Eingabefeld oder aus dem Netz.
const fremd = `<img src="kaputt.png" onerror="console.log('Hier läuft fremder Code')">`;

// Mit textContent steht der Text sichtbar da. Mehr passiert nicht.
document.getElementById("sicher").textContent = fremd;

// Mit innerHTML wird daraus ein echtes Element. Das Bild lädt nicht,
// also feuert onerror, und der fremde Code läuft.
document.getElementById("unsicher").innerHTML = fremd;

Solange das Markup aus dem eigenen Code kommt, ist innerHTML harmlos. Steckt aber auch nur ein Stück Text darin, das von jemand anderem kommt, ist es das nicht mehr.

Im dritten Beispiel steht in fremd ein Bild, das es nicht gibt. Ein Bild, das nicht lädt, löst sein onerror aus, und dort steht Code. Mit textContent gesetzt steht der Text sichtbar da, und es passiert nichts. Mit innerHTML wird er zu einem Element, das Bild scheitert, und der fremde Code läuft. In der Console steht danach eine Zeile, die niemand von der Seite geschrieben hat.

Im Reiter „Netzwerk“ siehst du dazu kaputt.png als fehlgeschlagene Anfrage. Der Browser hat die Datei also wirklich zu holen versucht, und erst ihr Scheitern löst den Code aus. Das klappt mit jedem Dateinamen, den es nicht gibt.

Diese Lücke heißt Cross-Site-Scripting, kurz XSS. Fremder Text wird zu ausgeführtem Code, und der läuft mit allen Rechten der Seite. Er sieht alles, was der Mensch davor sieht, und kann alles tun, was der eigene Code auch tun könnte.

<script> herauszufiltern reicht nicht. Über innerHTML eingesetzte <script>-Elemente laufen ohnehin nicht. Der Angriff kommt über Attribute wie onerror, onload oder onclick, und davon gibt es Dutzende.

Die Regel für den Rest des Kurses

Ich setze Text immer mit textContent. innerHTML nehme ich nur für Markup aus meinem eigenen Code, und auch dann nur, wenn kein fremder Text darin steckt. Sobald ein Nutzername, eine Sucheingabe oder eine Antwort aus dem Netz mit hineinwandert, ist es der falsche Weg.

Brauchst du wirklich neue Elemente, gibt es einen besseren Weg, nämlich document.createElement in Lektion 11.5. Das ist etwas mehr zu schreiben. Dafür kennt der Weg das Problem gar nicht erst, denn Text kann dort nie zu Markup werden.

In Lektion 20.3 kommt das Thema noch einmal dran. Die Regel steht trotzdem schon hier, weil man sie ab dieser Lektion brechen kann.

In der Aufgabe tauschst du drei Texte aus, und einer davon kommt aus einem Suchfeld.

Zum Mitnehmen

textContent setzt Text, innerHTML baut Markup und führt dabei auch fremde Attribute wie onerror aus. Für Text von außen nimmt der Kurs deshalb immer textContent.

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.