JavaScript-Budget: Drittanbieterskripte messen und begrenzen

Messen Sie die tatsächlichen Kosten von Analytics-, Chat-, Karten- und Werbeskripten; Inventar mit Verantwortlichen, async/defer, Facade, Tag-Manager-Regeln und Prüfung mit Lighthouse CI.
Technische Zusammenfassung
Technologie
JavaScript, async/defer, Google Tag Manager, Chrome DevTools Coverage, Lighthouse CI
Thema
JavaScript-Last einer Seite messen und mit einem Budget steuern
Niveau
Mittel
Voraussetzungen
  • Zugriff auf Vorlagen und Tag-Verwaltung der Website
  • Grundlegende Nutzung der Chrome DevTools
  • Berechtigung zum Ausführen von Befehlen in der CI/CD-Pipeline (für die Budgetprüfung)
In diesem Beitrag7 Abschnitte

Ist eine Seite schwerer geworden und sagt niemand, neuen Code geschrieben zu haben, schauen Sie auf die Skriptliste. Auf Unternehmenswebsites kommt der Großteil der JavaScript-Last nicht aus dem eigenen Code, sondern aus mit der Zeit hinzugefügten Drittanbieterskripten: Analytics, Werbepixel, Live-Chat, Karten, Video, A/B-Tests und Heatmap-Werkzeuge. Jedes wird von einem anderen Team mit eigener Begründung hinzugefügt. Die Gesamtkosten verfolgt niemand. Dieser Leitfaden beschreibt unsere Methode aus der Praxis, um JavaScript-Last zu messen, mit einem Performancebudget zu begrenzen und das Budget im Deployment-Prozess automatisch zu prüfen.

Was ist ein Performancebudget?

Ein Performancebudget ist die schriftliche Liste messbarer Grenzen, die eine Seite oder Vorlage nicht überschreiten darf. Was nicht schriftlich ist, ist kein Budget. Es lässt sich auf drei Arten definieren:

Budgetart Beispielkriterium Stärke
Menge Komprimierte JS-Größe, Zahl der Drittanbieteranfragen Leicht messbar, direkt unter Kontrolle des Entwicklers
Zeitplanung Total Blocking Time, LCP Näher an der Nutzererfahrung
Regel Bestehen von Lighthouse-Prüfungen Fängt bestimmte Fehler ab (z. B. renderblockierende Ressourcen)

Für JavaScript genügt ein Byte-Limit allein nicht. Von zwei gleich großen Skripten kann eines einmal laufen und fertig sein, während das andere ständig Timer und Listener einrichtet. Definieren Sie das Größenbudget daher zusammen mit einem Zeitkriterium (im Labor TBT, im Feld INP). Der Zahlenwert wird je Vorlage festgelegt, nachdem der Ist-Zustand gemessen und die Zielgeräteklasse bestimmt ist: Startseite, Leistungsseite, Blogbeitrag und Formularseite haben unterschiedliche Bedürfnisse.

Ein Skriptinventar erstellen

Ohne zu wissen, was geladen wird, lässt sich kein Budget steuern. Der erste Schritt ist ein Inventar aller geladenen Skripte je Vorlage. Neben technischen Angaben sollten im Inventar auch fachlicher Verantwortlicher und Begründung stehen. Ein Skript ohne auffindbaren Verantwortlichen ist ein Kandidat zum Entfernen; in Audits sehen wir, dass diese Liste keineswegs kurz ist.

Skript Verantwortlicher / Zweck Seiten, auf denen es geladen wird Ladeart
Analytics Marketing / Trafficmessung Alle async, einwilligungsabhängig
Live-Chat Vertrieb / Voranfrage Alle Synchron (zu überprüfen)
Karte Kontaktseite Alle (Fehler) Sollte seitenspezifisch sein
Heatmap Verantwortlicher unklar Alle Kandidat zum Entfernen

Für das Inventar wählen Sie im Network-Panel der DevTools den Filter JS und fügen die Spalte „Domain“ hinzu, um die anfragenden Domains zu sehen. Ein negativer Filter wie -domain:beispiel.de blendet Ihre eigene Domain aus und lässt nur Drittanbieter übrig. Um zu sehen, dass ein Skript weitere Skripte lädt (Verkettung), schauen Sie in die Spalte „Initiator“; über den Tag Manager geladene Tags erscheinen hier am Container-Skript.

Kosten von Drittanbieterskripten messen

Die Kosten eines Skripts bestehen nicht nur aus der Downloadgröße: Parsen, Kompilieren, Ausführen, hinzugefügte DOM-Elemente und eingerichtete Listener stehen ebenfalls auf der Rechnung. Nutzen Sie vier praktische Methoden zusammen:

  1. Lighthouse-Befund zu Drittanbietercode (in älteren Versionen third-party-summary, in aktuellen Versionen die Einsicht „3rd parties“): listet Drittanbieter mit Übertragungsgröße und auf dem Main Thread verbrauchter Zeit.
  2. Coverage-Panel: Öffnen Sie in den DevTools das Coverage-Panel und laden Sie die Seite neu; für jede Datei wird der Anteil der Bytes gezeigt, die heruntergeladen, aber während der Aufzeichnung nie ausgeführt wurden. Dieser Anteil spiegelt nur die Interaktionen während der Aufzeichnung; später genutzter Code wie Menü oder Formular kann ebenfalls „ungenutzt“ erscheinen. Große Dateien mit hohem ungenutztem Anteil sollten seitenspezifisch geladen oder aufgeteilt werden.
  3. Vergleich per Request Blocking: Klicken Sie im Network-Panel mit rechts auf eine Anfrage, blockieren Sie die Domain und messen Sie die Seite erneut. Die Differenz beider Messungen sind die tatsächlichen Kosten dieses Skripts für die Seite.
  4. Performance-Panel: Zeichnen Sie mit CPU-Drosselung auf und gruppieren Sie die Ansicht Bottom-Up mit „Group by domain“; sichtbar wird, auf welche Domains die Zeit des Main Threads entfällt.

Die dritte Methode beendet die Diskussion. Liegt die Zahl auf dem Tisch, überdenkt auch der Verantwortliche des Skripts seine Begründung.

Ladestrategien: async, defer, Facade

Können Sie ein Skript nicht ganz entfernen, senken Sie seine Kosten, indem Sie ändern, wann und wie es geladen wird.

async und defer

Ein <script src>-Tag ohne Attribut stoppt das HTML-Parsing. Ein async-Skript wird parallel heruntergeladen und läuft sofort danach; eine Reihenfolge ist nicht garantiert. defer-Skripte werden parallel heruntergeladen und nach Ende des HTML-Parsings in der Reihenfolge ausgeführt, in der sie stehen. Skripte mit type="module" verhalten sich standardmäßig wie defer. Ein Fehler, den wir in der Praxis oft sehen, ist async an einem von zwei voneinander abhängigen Skripten: Meist funktioniert es, manchmal gerät die Reihenfolge durcheinander, und der Fehler zeigt sich nur bei langsamer Verbindung. Ab WordPress 6.3 lässt sich die Ladestrategie für Theme- und Plugin-Skripte direkt bei der Registrierung angeben:

wp_enqueue_script(
    'firmen-ui',
    get_template_directory_uri() . '/assets/js/ui.js',
    array(),
    '2.4.0',
    array(
        'strategy'  => 'defer',
        'in_footer' => true,
    )
);

Laden bei Interaktion (Facade)

Eine Facade ersetzt eine schwere Komponente durch einen visuell ähnlichen, leichten Platzhalter und lädt das echte Skript erst, wenn der Nutzer interagiert. Auf Unternehmenswebsites wirkt sie am besten bei:

  • Video-Einbettungen: Statt des Videoplayers ein Vorschaubild mit Abspielbutton; beim Klick wird das iframe eingefügt.
  • Live-Chat: Ein statischer Button unten rechts; beim Klick oder nachdem der Nutzer eine bestimmte Zeit auf der Seite verbracht hat, wird das Chat-Skript geladen.
  • Karte: Auf der Kontaktseite ein statisches Kartenbild und ein Link „Karte öffnen“.
const chatButton = document.querySelector('#chat-starten');
chatButton.addEventListener('click', () => {
  const s = document.createElement('script');
  s.src = 'https://chat.beispiel-anbieter.com/widget.js';
  s.async = true;
  s.onload = () => window.ChatWidget?.open();
  document.head.appendChild(s);
}, { once: true });

Eine Facade hat ihren Preis: Beim ersten Klick öffnet sich die Komponente verzögert. Teilen Sie diese Verzögerung dem Nutzer mit einer Ladeanzeige mit und verifizieren Sie, dass die API des Anbieters programmatisches Öffnen unterstützt (der Aufruf open() oben hängt vom Anbieter ab). Andernfalls muss der Nutzer zweimal klicken.

Disziplin im Tag Manager

Tag-Manager wie Google Tag Manager verlagern das Hinzufügen von Skripten aus dem Entwicklungsprozess heraus. Ohne Disziplin wird das Budget hier am schnellsten gesprengt. Mindestregeln:

  • Im Namen oder in der Notiz jedes Tags stehen Verantwortlicher und Zweck; bei der vierteljährlichen Überprüfung werden verwaiste Tags pausiert.
  • Der Trigger „Alle Seiten“ wird nur Tags gegeben, die tatsächlich auf allen Seiten nötig sind; Kampagnenpixel werden auf die betreffenden Landingpages beschränkt.
  • Benutzerdefinierte HTML-Tags durchlaufen ein Code-Review; sie fügen der Seite direkt Skripte hinzu und sind am schwersten zu kontrollieren.
  • Klick- und Formular-Trigger werden nicht breiter als nötig definiert; Listener, die bei jedem Klick laufen, beeinflussen INP (Details im Leitfaden zur INP-Verbesserung).
  • Die Berechtigung für Container-Veröffentlichungen ist eingeschränkt, und jede Veröffentlichung erhält eine Beschreibung; so lässt sich eine Performance-Regression einer Veröffentlichung zuordnen.
  • Marketing- und Analytics-Tags werden abhängig von der Nutzereinwilligung geladen. Ein vor der Einwilligung nicht geladenes Tag ist nach KVKK (bzw. DSGVO) korrekt und beim ersten Laden kostenlos; Details zur Umsetzung im Leitfaden zum Laden von Tags nach Cookie-Einwilligung.

Das Budget in der CI prüfen

Ein schriftliches Budget, das nicht automatisch geprüft wird, ist innerhalb weniger Monate überschritten. Lighthouse CI misst festgelegte URLs mehrfach, vergleicht die Ergebnisse mit Schwellenwerten und lässt den Build bei Überschreitung fehlschlagen. Eine Beispiel-lighthouserc.json:

{
  "ci": {
    "collect": {
      "url": [
        "https://staging.beispiel.de/",
        "https://staging.beispiel.de/leistungen/beispiel-leistung/"
      ],
      "numberOfRuns": 3
    },
    "assert": {
      "assertions": {
        "resource-summary:script:size": ["error", { "maxNumericValue": 300000 }],
        "resource-summary:third-party:count": ["warn", { "maxNumericValue": 15 }],
        "total-blocking-time": ["warn", { "maxNumericValue": 300 }]
      }
    },
    "upload": {
      "target": "filesystem",
      "outputDir": "./lhci-bericht"
    }
  }
}
npm install -g @lhci/cli
lhci autorun

Die Schwellenwerte in diesem Beispiel zeigen nur die Syntax; leiten Sie Ihre eigenen Werte aus Ihrer aktuellen Messung ab. Die Größen von resource-summary sind in Byte, total-blocking-time in Millisekunden angegeben. Da sich Prüf-IDs zwischen Lighthouse-Versionen ändern können, verifizieren Sie, dass diese IDs im Bericht-JSON Ihrer Version vorhanden sind. Labormessungen schwanken von Lauf zu Lauf. Führen Sie mehrere Läufe durch, halten Sie Zeitkriterien zunächst auf Stufe „warn“ und heben Sie sie auf „error“, nachdem Sie das Rauschen beobachtet haben. Setzen Sie vom ersten Tag an „error“, beginnt das Team bald, eine zufällig rot werdende Pipeline zu ignorieren. Schritte zum Einbinden von Lighthouse CI in die Deployment-Pipeline finden Sie im Leitfaden zu CI/CD mit GitHub Actions.

Drittanbieterskripte können sich ohne Ihr Deployment ändern. Ergänzen Sie die CI-Prüfung daher durch eine periodische (z. B. tägliche) Messung gegen die Produktion und INP-Monitoring im Feld. Bei Budgetüberschreitung gilt eine einfache Regel: Ein neues Skript kommt nur hinzu, wenn im Budget Platz geschaffen wird (durch Entfernen eines anderen Skripts oder Umstellen auf eine Facade). Keine Ausnahme.

Für eine Tag-Architektur, die Messbedarf und Performancekosten ausbalanciert, siehe unsere Leistungsseiten Webanalyse und Conversion-Messung, für Festlegung und Monitoring des Budgets je Vorlage Webperformance und Core Web Vitals. Alle Konfigurationsoptionen von Lighthouse CI stehen in der Projektdokumentation von Lighthouse CI.

Häufig gestellte Fragen

Welche Zahl ist für ein Performancebudget richtig?

Eine universelle Zahl gibt es nicht. Messen Sie zuerst je Seitenvorlage die heutige JavaScript-Größe und Long-Task-Dauer, dann legen Sie als Budget das Niveau fest, mit dem die Schwellenwerte der Core Web Vitals in der Zielgeräteklasse erreicht werden. Entscheidend ist, dass die Zahl schriftlich festgehalten ist und jedes neue Skript daran gemessen wird.

Was ist der Unterschied zwischen async und defer?

Beide stoppen das HTML-Parsing beim Herunterladen des Skripts nicht. Ein async-Skript läuft sofort nach dem Download, eine Reihenfolge ist nicht garantiert; defer-Skripte laufen nach Ende des HTML-Parsings in der Reihenfolge, in der sie im Dokument stehen, und vor dem Ereignis DOMContentLoaded. Nutzen Sie defer für voneinander abhängige Skripte, async für unabhängige Messskripte.

Verlangsamt ein Tag Manager die Seite?

Das Container-Skript selbst ist ein Kostenfaktor, die eigentliche Last kommt aber von den darin hinzugefügten Tags. Verwaiste benutzerdefinierte HTML-Tags, auf allen Seiten ausgelöste Marketing-Pixel und Klick-Listener beeinflussen sowohl Ladezeit als auch INP. Werden Verantwortlicher, Zweck und Triggerbereich der Tags regelmäßig überprüft, bleibt der Tag Manager beherrschbar.

Sollte Lighthouse CI gegen die Produktivwebsite laufen?

Ziel der Budgetprüfung ist es, Überschreitungen vor dem Livegang zu erkennen; führen Sie sie daher gegen die Testumgebung oder eine in der CI hochgefahrene Vorschauumgebung aus. Ein periodischer Lauf gegen die Produktion ist eine zusätzliche Kontrolle, um zu bemerken, dass sich Drittanbieterskripte ohne Ihr Deployment ändern.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge