Documentation
Framework
Version
Debouncer API Reference
Throttler API Reference
Rate Limiter API Reference
Queue API Reference
Batcher API Reference

ReactThrottler

Interface: ReactThrottler<TFn, TSelected>

Defined in: react-pacer/src/throttler/useThrottler.ts:13

Extends

  • Omit<Throttler<TFn>, "store">

Type Parameters

TFn

TFn extends AnyFunction

TSelected

TSelected = { }

Properties

state

ts
readonly state: Readonly<TSelected>;
readonly state: Readonly<TSelected>;

Defined in: react-pacer/src/throttler/useThrottler.ts:39

Reactive state that will be updated and re-rendered when the throttler state changes

Use this instead of throttler.store.state


store

ts
readonly store: Store<Readonly<ThrottlerState<TFn>>>;
readonly store: Store<Readonly<ThrottlerState<TFn>>>;

Defined in: react-pacer/src/throttler/useThrottler.ts:45

Deprecated

Use throttler.state instead of throttler.store.state if you want to read reactive state. The state on the store object is not reactive, as it has not been wrapped in a useStore hook internally. Although, you can make the state reactive by using the useStore in your own usage.


Subscribe()

ts
Subscribe: <TSelected>(props) => ReactNode | Promise<ReactNode>;
Subscribe: <TSelected>(props) => ReactNode | Promise<ReactNode>;

Defined in: react-pacer/src/throttler/useThrottler.ts:30

A React HOC (Higher Order Component) that allows you to subscribe to the throttler state.

This is useful for opting into state re-renders for specific parts of the throttler state deep in your component tree without needing to pass a selector to the hook.

Type Parameters

TSelected

TSelected

Parameters

props
children

ReactNode | (state) => ReactNode

selector

(state) => TSelected

Returns

ReactNode | Promise<ReactNode>

Example

ts
<throttler.Subscribe selector={(state) => ({ isPending: state.isPending })}>
  {({ isPending }) => (
    <div>{isPending ? 'Throttling...' : 'Ready'}</div>
  )}
</throttler.Subscribe>
<throttler.Subscribe selector={(state) => ({ isPending: state.isPending })}>
  {({ isPending }) => (
    <div>{isPending ? 'Throttling...' : 'Ready'}</div>
  )}
</throttler.Subscribe>