onUpdate()

Der vorgesehene Update-Slot des Dashlet-Handles. Er erhält den normalisierten InitContext erneut, sobald der Host eine Auswahl- oder Kontext-Änderung nach der Init-Auflösung meldet. Die vollständige Update-Semantik ist eine spätere Änderung — der Slot ist der stabile, bereits verkabelte Einstiegspunkt dafür.

1. Signatur

onUpdate(listener: (ctx: InitContext, info: UpdateInfo) => void): () => void;

  • listener — erhält den frisch normalisierten InitContext (dieselbe Form wie init) und ein UpdateInfo-Objekt, dessen source immer 'update' ist.

  • Gibt eine Abmeldefunktion zurück.

2. Was hier läuft

Quell-Event Umgebung

onUpdate-Nachrichten vom Host

webclient

spätere onInit-Nachrichten (Dashboard-Zurück-Schalten — das Init hat sich bereits beim ersten aufgelöst)

webclient

Rich-Client-Host-Callbacks nach dem ersten (der erste Callback ist das Init; spätere sind Updates)

rich client

das v10.10-Warm-up-Refresh (leere Umgebung am Client-Start; die Neu-Emission trägt die befüllten Werte, sobald sie erscheinen)

rich client

Alles wird als normalisierter InitContext zugeliefert — der Listener muss nicht wissen, welcher Event-Typ die Emission ausgelöst hat.

3. Hinweise

  • Listener, die vor der Init-Auflösung registriert werden, feuern nie aus der Auflösung selbst — die Auflösung geht an onInit (und das init-Promise); Updates beginnen mit dem ersten Post-Settle-Event.

  • Eine von einem onUpdate-Listener geworfene Ausnahme wird an die onError-Listener geroutet — sie bricht nie den Host-Aufruf oder die anderen Listener.

4. Beispiele

const off = dashlet.onUpdate((ctx, info) => {
    // info.source === 'update' immer
    rerender(ctx);
});

// später
off(); // abmelden