StateBeginnerFully SSR-safehooks/state/useSetState.ts

useSetState

Object state with shallow merge, class-component style.

Import

TypeScript
import { useSetState } from '@/hooks';

API

Signature

useSetState<T>(initial) → [state, setMerge]

When to use

Use useSetState instead of re-implementing the same pattern in multiple components.

SSR / Next.js

Fully SSR-safe. Pure React state.

Live playground

Edit the example and see it run against the real @/hooks package in this app.

Live playgroundEdit · run with real @/hooks · useSetState
Editor
function ProfileForm() {
  const [state, setState] = useSetState({ name: '', age: 0 });

  return (
    <>
      <input
        value={state.name}
        onChange={(e) => setState({ name: e.target.value })}
      />
      <button onClick={() => setState((s) => ({ age: s.age + 1 }))}>
        Age {state.age}
      </button>
    </>
  );
}
Preview

Implementation source

Full library source for useSetState — copy into your project when you are not installing a package yet.

hooks/state/useSetState.ts
import { useCallback, useState } from 'react';

export type SetStateActionPartial<T extends object> =
  | Partial<T>
  | ((prev: T) => Partial<T>);

/**
 * Object state with shallow merge (class component setState style).
 */
export function useSetState<T extends object>(
  initialState: T | (() => T),
): [T, (patch: SetStateActionPartial<T>) => void] {
  const [state, setState] = useState(initialState);

  const setMerge = useCallback((patch: SetStateActionPartial<T>) => {
    setState((prev) => {
      const next = typeof patch === 'function' ? patch(prev) : patch;
      return { ...prev, ...next };
    });
  }, []);

  return [state, setMerge];
}

Copy-paste example

useSetState.example.tsx
'use client';

import { useSetState } from '@/hooks';

export function ProfileForm() {
  const [state, setState] = useSetState({ name: '', age: 0 });

  return (
    <>
      <input
        value={state.name}
        onChange={(e) => setState({ name: e.target.value })}
      />
      <button onClick={() => setState((s) => ({ age: s.age + 1 }))}>
        Age {state.age}
      </button>
    </>
  );
}

Production checklist

  • Called only from Client Components or other custom hooks
  • Type parameters filled in (e.g. useFetch<User[]>)
  • Tip: Keep state setters stable; prefer action helpers over manual setState spreads.
  • Source of truth: open hooks/state/useSetState.ts for implementation details