Frontend States Throttling

Frontend States Throttling reduziert, wie häufig State-Updates im Browser zu Re-Renders führen. Das kann bei Dashboards mit sehr vielen Entitäten, schnellen Sensoren oder leistungsschwachen Geräten helfen.

Was wird gedrosselt?

Gedrosselt werden Frontend-State-Update-Verarbeitungen im Browser. Home Assistant selbst, Automationen und Backend-State-Änderungen werden dadurch nicht verlangsamt.

Aktivierung über die Integrations-UI

1. In Home Assistant zu Settings -> Devices & Services -> UI eXtension -> Configure gehen.
2. Performance settings öffnen.
3. Throttle entity state updates aktivieren.
4. Optional das Throttle interval einstellen.
5. Speichern.

So funktioniert es

UIX sammelt schnelle State-Update-Signale im Browser und lässt Aktualisierungen nur in einem konfigurierten Mindestabstand durch. Dadurch sinkt die Zahl der Re-Renders.

Letztes Update flushen

Wenn während eines Throttle-Fensters ein Update zurückgehalten wurde, wird das letzte Update nach Ablauf des Fensters nachgezogen. So bleibt die Anzeige aktuell, ohne jede Zwischenänderung sofort zu rendern.

Clientseitige Override-API

window.uixCoordinator stellt eine Override-Methode bereit, mit der Integrationen wie Browser Mod pro Browser, Nutzer oder Gerät Einstellungen setzen können.

window.uixCoordinator.setThrottleOverride(500)
window.uixCoordinator.setThrottleOverride(null)

Mit Browser Mod verwenden

# In der Browser-Mod-Konfiguration für eine bestimmte Browser-ID:
service: browser_mod.javascript
data:
  browser_id: kitchen-tablet
  code: |
    window.uixCoordinator?.setThrottleOverride(500)

Mit custom:button-card verwenden

# Throttling mit 500 ms für diese Browser-Session aktivieren:
tap_action:
  action: fire-dom-event
  uix:
    action: javascript
    data:
      code: window.uixCoordinator?.setThrottleOverride(500)

# Throttling-Override für diese Browser-Session deaktivieren:
hold_action:
  action: fire-dom-event
  uix:
    action: javascript
    data:
      code: window.uixCoordinator?.setThrottleOverride(null)

Konfigurationsreferenz

Einstellung	Standard	Beschreibung
Throttle entity state updates	Aus	Aktiviert oder deaktiviert die State-Drosselung global.
Throttle interval	200 ms	Mindestabstand zwischen State-Update-Re-Renders. Bereich: 50 bis 10.000 ms.

Wann sollte Throttling genutzt werden?

Nutze Throttling bei Dashboards mit vielen Karten, vielen schnell wechselnden Sensoren oder Geräten, auf denen das Frontend spürbar ruckelt.

WARNING

Ein zu großes Intervall kann Anzeigen träge wirken lassen. Starte konservativ, zum Beispiel mit 200 bis 500 ms, und prüfe die Bedienung danach im Alltag.

Reihenfolge der Einstellungen

Quelle	Wirkung
Integrations-UI	Globaler Standard für alle Browser
setThrottleOverride(500)	Setzt das Intervall für diese Browser-Session auf 500 ms
setThrottleOverride(null)	Entfernt den Session-Override und nutzt wieder den globalen Standard

Der Session-Override eignet sich für Geräte mit schwacher Hardware, etwa ältere Tablets, ohne schnelle Desktop-Browser unnötig zu bremsen.

Was nicht gedrosselt wird

Frontend States Throttling betrifft nur die Verarbeitung im Browser.

• Home-Assistant-States im Backend werden normal aktualisiert.
• Automationen laufen unverändert.
• MQTT, Recorder, History und Template-Sensoren werden nicht gebremst.
• Services werden weiterhin sofort ausgeführt.

Gedrosselt wird nur, wie oft das Frontend State-Änderungen an UI-Elemente weitergibt und dadurch Re-Renders auslöst.

Geeignete Intervalle

Intervall	Einsatz
50 bis 150 ms	Sehr leichte Drosselung, kaum sichtbar
200 bis 500 ms	Gute Startwerte für große Dashboards
1000 ms	Für Wanddisplays mit vielen Sensoren
Über 1000 ms	Nur testen, wenn Trägheit akzeptabel ist

Beispiele für problematische Dashboards

• viele Energie-, Leistungs- oder Wetter-Sensoren mit schnellen Updates
• große Karten wie Map, History, ApexCharts oder Auto-Entities
• mehrere Tabs/Views auf schwacher Tablet-Hardware
• viele Template-Ausdrücke in UIX-Styles
• viele Karten mit häufig aktualisierten Entities

Prüfen, ob es hilft

1. Dashboard ohne Throttling öffnen.
2. Browser-Performance oder sichtbares Ruckeln beobachten.
3. Throttling mit 200 ms aktivieren.
4. Dashboard neu laden.
5. Schrittweise auf 500 ms oder 1000 ms erhöhen, wenn es noch ruckelt.

Wenn wichtige Anzeigen zu langsam reagieren, reduziere das Intervall wieder oder nutze einen Session-Override nur auf dem betroffenen Gerät.