Function: useOnQuery()

function useOnQuery<R, P, T>(host: ReactiveElement, options: UseOnQueryOptions<R, P, T>): OnQueryController<R, P, T>;

Defined in: src/wirestate-lit/queries/use-on-query.ts:48

Registers a query handler for the host element's lifetime.

Type Parameters

Type Parameter	Default type
R	unknown
P	unknown
T extends QueryType	QueryType

Parameters

Parameter	Type	Description
host	ReactiveElement	Host element.
options	UseOnQueryOptions<R, P, T>	Query handling options.

Returns

OnQueryController<R, P, T>

Query controller.

Remarks

Registers when the host connects, unregisters when it disconnects, and re-registers when the nearest container context changes. Query handlers are stack-based on the active query bus.

Example

class MyElement extends LitElement {
  private getUserController = useOnQuery(this, {
    type: "GET_USER",
    handler: (payload) => ({ name: "Alice" }),
  });
}