<!--
Sitemap:
- [rxfy](/index): Typed, normalized, reactive state — built on RxJS
- [Comparison](/comparison): rxfy versus Redux Toolkit, MobX, Jotai, TanStack Query, and TanStack DB
- [Inspired by](/inspired-by): the libraries and ideas rxfy grew out of
- [Agent Skills](/agent-skills): Accurate rxfy context for AI coding assistants
- [Examples](/examples): Runnable apps, from client-only to fully synced
- [Changelog](/changelog)
- [Getting Started](/getting-started)
- [Create Store](/getting-started/create-store): Normalized reactive state in a client-only app
- [Add SSR](/getting-started/add-ssr): Render the first paint on the server, hydrate with no refetch
- [Add Sync Client](/getting-started/add-sync-client): The full stack: the server publishes, the client syncs
- [Core Concepts](/core-concepts): The ideas rxfy is built on
- [Observables](/core-concepts/observables): A value that changes over time, that you can subscribe to
- [Normalization](/core-concepts/normalization): Store each entity once, reference it by id
- [Late Unwrapping](/core-concepts/late-unwrapping): Unwrap async state at the leaf, not the trunk
- [Server-Side Rendering](/core-concepts/ssr): Dehydrate on the server, hydrate with no refetch
- [rxfy](/rxfy): The core package: atoms, lenses, models, and states
- [createModel](/rxfy/create-model): Typed entities in normalized storage
- [defineState](/rxfy/define-state): Typed, normalized state shapes with fetching and mutations
- [createAtom](/rxfy/create-atom): A reactive cell with synchronous get, set, and modify
- [createLens](/rxfy/create-lens): A two-way view into part of an Atom
- [React Bindings](/react): Hooks and helpers for using rxfy in React
- [useStateData](/react/use-state-data): Fetch, normalize, and subscribe to a query
- [useStatePagedData](/react/use-state-paged-data): Paginated and infinite-scroll lists
- [useModelStore](/react/use-model-store): Subscribe to one normalized entity by id
- [useAtom](/react/use-atom): Two-way binding for any IAtom
- [Pending](/react/pending): Render pending, rejected, and fulfilled UI for any observable
- [usePending](/react/use-pending): The status value behind Pending
- [useObservable](/react/use-observable): Bind a raw Observable to React
- [Sync Client in React](/react/sync-client): StoreProvider, useSyncClient, and update handles
- [rxfy-client](/framework/client): The framework-agnostic browser sync runtime
- [createSyncClient](/framework/client/create-sync-client): Connect a transport and drive the sync loop
- [readSsrGrants](/framework/client/read-ssr-grants): Lift SSR-embedded channel grants
- [rxfy-server](/framework/server): Bind Drizzle tables, write, and publish sync updates
- [defineResource](/framework/server/define-resource): Tie a Drizzle table to an rxfy model
- [createSync](/framework/server/create-server): Wire a storage adapter, hub, and secret into a Live object
- [createInMemoryHub](/framework/server/hub): The socket-keyed pub/sub backbone
- [Writes](/framework/server/writes): sync.create / sync.update / sync.delete and touch
- [Storage adapters](/framework/server/storage-adapters): Persist writes with Drizzle or in memory
- [Sync messages](/framework/server/messages): What travels between server and client
- [Grants](/framework/server/grants): The server signs what it serves; the client subscribes with the token
- [rxfy-ws](/framework/ws): The default WebSocket transport
- [createWsServer](/framework/ws/server): Attach a Hub to WebSocket connections
- [createWsClient](/framework/ws/client): The browser transport with reconnect and replay
- [Custom transports](/framework/ws/custom-transport): Bring your own ClientTransport
- [Guides](/guides): Task-focused walkthroughs of common rxfy patterns
- [Pagination and infinite scroll](/guides/pagination): Load and append pages into one normalized list
-->

# Pending \[Render pending, rejected, and fulfilled UI for any observable]

Subscribes to any `ObservableLike<T>` and renders pending / rejected / fulfilled UI. The
`rejected` render prop receives `{ error: unknown }`. If `rejected`
is omitted it renders nothing and logs the error to `console.error`.

Reload is not carried on the status object: get it from the [`useStateData`](/react/use-state-data)
handle's `reload()` (or `getAttachedReload(source$)` for a standalone observable).

`Pending` is the preferred way to unwrap async state for rendering — it keeps the unwrap at the
render edge ([late unwrapping](/core-concepts/late-unwrapping)), whereas the [`usePending`](/react/use-pending)
hook pulls the status branch up into the component body. It also revalidates smoothly: a reload
refetches in place (`data$` keeps its identity and skips the interim `PENDING`), so `Pending` holds
the last fulfilled value across a background refresh — a live `stale` update swaps the content
underneath with no pending flash.

```tsx
import { useMemo, useState } from "react";
import { Pending, useStateData } from "rxfy-react";
import { todosState, fetchTodos } from "./todos";

function Todos() {
  const [filter] = useState<"all" | "active" | "done">("all");
  const params = useMemo(() => ({ filter }), [filter]);
  const { data$, reload } = useStateData({ state: todosState, fetchFn: fetchTodos, params });

  return (
    <Pending
      value$={data$}
      pending={<p>Loading...</p>}
      rejected={({ error }) => (
        <p>
          Error: {String(error)} <button onClick={reload}>Retry</button>
        </p>
      )}
    >
      {({ todos }) => (
        <ul>
          {todos.map((id) => (
            <TodoItem key={id} id={id} />
          ))}
        </ul>
      )}
    </Pending>
  );
}
```

```ts
function Pending<T>(props: IPendingProps<T>): React.ReactNode;
```

Its props are:

```ts
type IPendingProps<T> = {
  value$: ObservableLike<T>; // source to subscribe to
  pending?: IRenderable<void>; // shown while PENDING (default: nothing)
  rejected?: IRenderable<IWrapped<T, StatusEnum.REJECTED>>; // shown on REJECTED
  children: IRenderable<T>; // shown with the FULFILLED value
  getDefaultValue?: () => T; // start FULFILLED instead of PENDING
};

type IRenderable<TData> = React.ReactNode | ((data: TData) => React.ReactNode);
type ObservableLike<T> = Observable<T> | T;
```

:::warning
`Pending` is powered by the lower-level [`usePending`](/react/use-pending) hook. The `source$`
you pass must be referentially stable across renders, and `data$` from `useStateData` already is.
:::
