fb.cursor Cursor Visibility

fb.cursor explicitly controls the calling window's client-area cursor. State and the cursor:hiddenChanged event are scoped to the originating window, so popups can manage visibility independently.

isHidden()

Signature: fb.cursor.isHidden(): Promise<CursorIsHiddenResponse>

Returns { hidden } for the calling window. If the host cannot resolve that window, the response falls back to { hidden: false }.

const res = await fb.cursor.isHidden();
if (res.success === false) throw new Error(res.error);
const { hidden } = res;

setHidden(hidden)

Signature: fb.cursor.setHidden(hidden: boolean): Promise<CursorSetHiddenResponse>

Hides the cursor when hidden is true and restores it when false. Repeating the current state resolves with success: true and changed: false; only actual state changes emit cursor:hiddenChanged. Fails with OPERATION_FAILED when the host cannot resolve the calling window.

await fb.cursor.setHidden(true);

Event

cursor:hiddenChanged carries { hidden: boolean } and is delivered only to the window that changed its cursor state.