Weniger JavaScript beim Laden: Code-Splitting mit import()
Kurz gesagt: Viele Web-Apps laden beim ersten Aufruf ihren gesamten JavaScript-Code, auch Teile, die kaum jemand braucht: den PDF-Generator für Angebote, die Diagrammbibliothek für Auswertungen oder den Texteditor für Notizen. Das kostet Ladezeit, besonders auf Handys. Mit Code-Splitting teilen Sie den Code in Pakete auf und laden seltene Funktionen erst, wenn sie gebraucht werden. Technisch geschieht das mit dem dynamischen import(), das laut MDN ein Modul asynchron lädt und ein Promise zurückgibt. Verbreitete Bundler wie webpack, Parcel und Rollup erzeugen daraus laut web.dev automatisch eigene Pakete. Wichtig ist eine Fehlerbehandlung für den Fall, dass ein Paket nach einem Update nicht mehr gefunden wird.
Woran Sie zu große JavaScript-Pakete erkennen
Ein überladenes Paket macht sich bemerkbar, obwohl die App eigentlich gut funktioniert:
- Der Anmeldebildschirm erscheint am Handy erst nach mehreren Sekunden.
- Ein Leistungstest meldet viel ungenutztes JavaScript oder lange Ausführungszeiten.
- Die Hauptdatei Ihrer App ist mehrere Megabyte groß.
- Neue Funktionen machen die ganze App langsamer, auch für Nutzer, die sie nie verwenden.
Typisch ist das für Kundenportale, Buchungssysteme und interne Werkzeuge, die über Jahre gewachsen sind. Jede neue Funktion hat eine weitere Bibliothek mitgebracht, und alles landet in einer Datei.
Wie Code-Splitting funktioniert
web.dev beschreibt das Prinzip so: Teilen Sie das JavaScript-Paket auf, damit beim ersten Laden nur der Code für die erste Ansicht übertragen wird. Dadurch muss der Browser weniger Skript verarbeiten, und die Seite lädt schneller.
Das Werkzeug dafür ist das dynamische import(). Laut MDN lädt es ein Modul asynchron und gibt ein Promise zurück, das mit dem Inhalt des Moduls erfüllt wird. Anders als die normale import-Anweisung am Dateianfang lässt es sich bedingt oder bei Bedarf aufrufen. MDN nennt als typischen Grund, dass ein statischer Import das Laden deutlich verlangsamt und der Code nur selten oder erst später gebraucht wird.
Ein Beispiel für einen Knopf, der ein Angebot als PDF erstellt:
pdfButton.addEventListener("click", async () => {
const { erstellePdf } = await import("./pdf-angebot.js");
erstellePdf(angebot);
});
Der Bundler erkennt den dynamischen Import und legt pdf-angebot.js samt seiner Abhängigkeiten in ein eigenes Paket. Es wird erst beim Klick geladen.
Gute Kandidaten für eigene Pakete
Nicht jeder Teil lohnt sich. Sinnvoll sind vor allem:
- Große Bibliotheken für einzelne Funktionen: PDF-Erzeugung, Diagramme, Karten, Texteditoren, Bildbearbeitung.
- Ganze Bereiche der App: Verwaltung, Auswertungen, Einstellungen. Viele Frameworks können pro Route ein eigenes Paket bilden.
- Seltene Dialoge: Datenimport, Exportassistent, Hilfeassistent.
- Funktionen für einzelne Rollen: Ein Bereich nur für Administratoren muss nicht bei jeder Kundin geladen werden.
Kleine Hilfsfunktionen, die überall gebraucht werden, gehören dagegen ins Hauptpaket. Zu viele winzige Pakete erzeugen eigene Wartezeiten.
Die kurze Wartezeit gestalten
Beim ersten Klick auf eine ausgelagerte Funktion muss das Paket erst geladen werden. Zeigen Sie dafür einen kurzen Ladezustand, etwa einen Hinweis „PDF wird vorbereitet“ und einen deaktivierten Knopf, damit niemand mehrfach klickt.
Sie können die Wartezeit auch verkürzen, indem Sie Pakete im Voraus laden, sobald klar ist, dass sie bald gebraucht werden. Ein Beispiel: Sobald jemand die Angebotsansicht öffnet, beginnt die App im Hintergrund das PDF-Paket zu laden. Beim Klick ist es dann schon da.
Fehler nach Updates abfangen
Ein häufiger Stolperstein: Nach einem Update haben die Pakete neue Dateinamen. Hat ein Nutzer die App noch in einem alten Tab offen und klickt auf eine ausgelagerte Funktion, fragt sein Browser nach einem Paket, das es auf dem Server nicht mehr gibt. Das Promise von import() wird dann abgelehnt.
Planen Sie dafür zwei Dinge ein:
- Alte Pakete eine Weile behalten. Löschen Sie beim Veröffentlichen nicht sofort alle alten Dateien, sondern erst nach einigen Tagen.
- Fehler freundlich behandeln. Fangen Sie den Fehler ab und zeigen Sie einen Hinweis wie „Die App wurde aktualisiert. Bitte laden Sie die Seite neu.“ mit einem Knopf zum Neuladen.
So wird aus einem rätselhaften Absturz eine verständliche Bitte.
Was Sie mit Ihrer Agentur besprechen sollten
Für Auftraggeber ohne eigenes Entwicklerteam reichen einige konkrete Fragen, um das Thema anzustoßen: Wie groß ist das erste JavaScript-Paket heute? Welche drei Bibliotheken belegen darin am meisten Platz? Welche davon werden beim ersten Aufruf wirklich gebraucht? Und wie reagiert die App, wenn nach einem Update ein altes Paket fehlt? Lassen Sie sich die Antworten mit einer Messung vorher und nachher belegen. So wird aus einem abstrakten Wunsch nach mehr Geschwindigkeit ein überprüfbares Ziel.
Den Effekt messen
Bevor Sie umbauen, messen Sie, wo der meiste Code steckt. Viele Bundler können eine Übersicht erzeugen, die zeigt, welche Bibliothek wie viel Platz im Paket belegt. Zusätzlich zeigt das Coverage-Panel in den Chrome-Entwicklerwerkzeugen, wie viel des geladenen JavaScripts auf einer Seite tatsächlich verwendet wird.
Messen Sie nach dem Umbau erneut, am besten mit gedrosselter Verbindung und auf einem echten Handy. Vergleichen Sie die Größe des ersten Pakets und die Zeit bis zur ersten Ansicht.
Schrittweise vorgehen
Code-Splitting muss nicht in einem großen Projekt passieren. Bewährt hat sich ein Vorgehen in kleinen Schritten:
- Die größte Bibliothek identifizieren, die nur an einer Stelle gebraucht wird.
- Sie per import() an genau diese Stelle verschieben, mit Ladezustand und Fehlerbehandlung.
- Messen, testen, veröffentlichen.
- Mit dem nächsten Kandidaten weitermachen.
Schon die erste Auslagerung bringt oft einen spürbaren Unterschied, weil einzelne Bibliotheken einen großen Teil des Gesamtpakets ausmachen.
Beispiel aus der Praxis
Eine Gärtnerei in Freiburg betreibt ein Bestellportal für Firmenkunden, die Pflanzen für Büros und Außenanlagen ordern. Das Portal lud beim Start eine Diagrammbibliothek für Auswertungen und einen PDF-Generator für Lieferscheine, obwohl die meisten Kunden nur bestellen wollten. Nach dem Auslagern beider Funktionen per import(), mit Vorladen beim Öffnen des jeweiligen Bereichs und einem Hinweis bei Update-Fehlern, erscheint die Bestellübersicht am Handy deutlich schneller. Das Beispiel ist illustrativ.
Häufige Fragen
Muss ich dafür mein Framework wechseln?
Nein. Verbreitete Bundler unterstützen dynamische Importe, und viele Frameworks bieten eine eigene Schreibweise für das Aufteilen nach Seiten oder Komponenten.
Wie viele Pakete sind sinnvoll?
So viele wie nötig, so wenige wie möglich. Lagern Sie große, selten genutzte Teile aus und behalten Sie häufig genutzten Code im Hauptpaket.
Was passiert, wenn ein Paket nicht geladen werden kann?
Das Promise von import() wird abgelehnt. Fangen Sie den Fehler ab, bieten Sie ein Neuladen an und behalten Sie alte Pakete nach Updates eine Zeit lang auf dem Server.
Hilft das auch bei klassischen Websites?
Bei Websites mit wenig JavaScript ist der Effekt geringer. Bei interaktiven Seiten mit Karten, Konfiguratoren oder Galerien lohnt es sich ebenso.
Wenn Ihre Web-App beim Start zu viel JavaScript lädt, planen wir das Aufteilen gerne gemeinsam mit Ihnen: JavaScript-Pakete prüfen lassen.