setBrowserCaption(caption)

Setzt die Vorschau-Überschrift (Caption) im Rich Client. Eine der Rich-Client-Handle-Methoden, verfügbar über getRichClientApi() — ein direkter, synchroner Bridge-Write auf das Bridge-Mitglied osjxSetBrowserCaption: keine Validierung, die Zeichenkette unverändert direkt an die Bridge.

1. Signatur

setBrowserCaption(caption: string): void;

2. Parameter

Name Typ Beschreibung

caption

string

Die Vorschau-Überschrift, die gesetzt werden soll — unverändert an die Bridge übergeben.

3. Verhalten

  • Synchron: Die Bridge ist ein synchroner COM-/JS-Aufruf — setBrowserCaption(caption) ruft osjxSetBrowserCaption(caption) sofort auf und liefert void; es gibt kein Promise, das abzuwarten wäre.

  • Direkter Bridge-Write: Die caption-Zeichenkette geht direkt an das Bridge-Mitglied osjxSetBrowserCaption — ohne Validierung und ohne Normalisierung.

  • Throw-safe: Ein fehlendes Bridge-Mitglied wirft die beschreibende TypeError; ein werfender Bridge-Aufruf wird in die beschreibende Error umgewandelt — nie ein unkontrolliertes Throw des Host-Proxy, auf jeder Clientversion (siehe Fehler).

  • Verzögertes Lesen pro Aufruf: Der Handle liest window.osClient pro Aufruf (kein Snapshot zur Handle-Erstellung) — ein später injizierter oder ausgetauschter Bridge-Zustand wird sofort sichtbar.

  • Reduzierte COM-OpenBrowser-Bridge: Sie trägt genau zwei Mitglieder — osjxGetBrowserEnvironment + osjxSetBrowserCaption. Dieses Mitglied ist eines der zwei, daher funktioniert der Aufruf auf dieser Oberfläche, auch wenn die Dashlet-Mitglieder (z. B. osjxGetSelectedObjects) fehlen.

4. Beispiele

rich.setBrowserCaption('Vorschau');

5. Fehler

  • Error('dashlet destroyed') — das Dashlet wurde vor dem Aufruf zerstört.

  • TypeError: Dashlet.getRichClientApi(): the environment is not resolved yet - await the dashlet.init promise first — der Handle wurde angefordert, bevor die Umgebung aufgelöst war (Accessor-Fehler).

  • TypeError: Dashlet.getRichClientApi(): the rich client API handle is only available in the richClient environment (current: …) — der Handle wurde in der falschen Umgebung angefordert (Accessor-Fehler; der aktuelle Wert wird genannt).

  • TypeError: Dashlet: the rich-client bridge does not expose "osjxSetBrowserCaption" (bridge method missing) — das Bridge-Mitglied fehlt (die Bridge zum Aufrufzeitpunkt legt es nicht ab).

  • Error: Dashlet: rich-client bridge call "osjxSetBrowserCaption" failed: … — der Bridge-Aufruf selbst hat eine Ausnahme geworfen (das Detail nennt den Bridge-Fehler).