Lazy hubs

By default, the library connects every hub in the contract when the app starts. A lazy hub connects only when a consumer needs it. Set lazy: true for one hub, or for all hubs.

Grace periodCopy Anchor Link

graceMs is the time that a lazy hub stays connected after its last consumer leaves. A short grace period prevents a disconnect and a new connect when a component remounts quickly. The default is 0. graceMs is a per-hub option.

When the grace period ends, the hub stops and its status is "idle". When a consumer comes back, the hub connects again.

What counts as a consumerCopy Anchor Link

The library counts the consumers of each hub. The hub is wanted while the count is more than 0. A consumer is not a component. It is one call of a helper that is bound to a hub.

Each of these counts as a consumer for the hub that you pass:

• useHubConsumer, which keeps the hub connected and does nothing else.
• useSignalREffect, useSignalRInvoke, useSignalRSend, and useSignalRTeardown.
• useHubStatus and useOnReconnected.

The consumer ends when the component unmounts.

A status banner for a lazy hub also connects that hub. To read the status without a connection, use useSignalR. Its getStatus function does not count as a consumer.

Here, a component keeps the lazy presence hub alive and shows its online count:

import { useState } from "react";
import { useSignalREffect } from "./client";

export function OnlineCount() {
  const [count, setCount] = useState<number>();

  useSignalREffect("/hubs/presence", "OnlineCount", (online) => setCount(online));

  return <span>{count ?? "..."} online</span>;
}

A teardown call holds a lazy hub open until it is sent, even after its own consumer leaves.