re:re:actable
Урок 123 минуты чтения

Клиентское и серверное состояние

На этой странице
Кратко

Клиентское состояние описывает локальное взаимодействие. Серверное состояние представляет данные удаленного источника, клиентская копия которых может устаревать.

Вопрос

Почему данные API отличаются от флага открытия панели и какие задачи добавляет серверное состояние?

Основная идея

Открыта ли подсказка - решение текущего интерфейса. Список курсов, баланс или права пользователя обычно принадлежат серверу и могут измениться из-за другого пользователя или фоновой операции.

Клиент видит только копию серверных данных на определенный момент. Нужно учитывать загрузку, ошибки, кеш, повторные запросы и конфликты изменений.

Различие определяется владельцем и способом синхронизации, а не только местом хранения. Ответ API после получения тоже находится в памяти браузера, но от этого не становится исключительно локальным UI-state.

Пример: данные курса и локальные подробности

В примере для самостоятельности API заменен учебной Promise-функцией.

import { useEffect, useState } from "react";
 
function loadCourse() {
  return Promise.resolve({ title: "React", lessons: 12 });
}
 
export default function Course() {
  const [course, setCourse] = useState(null);
  const [expanded, setExpanded] = useState(false);
 
  useEffect(() => {
    let ignore = false;
    loadCourse().then(result => {
      if (!ignore) setCourse(result);
    });
    return () => { ignore = true; };
  }, []);
 
  if (course === null) return <p role="status">Загрузка...</p>;
 
  return (
    <article>
      <h2>{course.title}</h2>
      <button onClick={() => setExpanded(value => !value)}>Подробности</button>
      {expanded && <p>Уроков: {course.lessons}</p>}
    </article>
  );
}

expanded - локальное взаимодействие. course - клиентская копия данных внешнего источника. Для реального API понадобятся также HTTP-проверка и обработка ошибок.

То же самое с библиотекой серверного состояния

import { useQuery } from "@tanstack/react-query";
import { useState } from "react";
 
export default function Course({ id }) {
  const [expanded, setExpanded] = useState(false);              // клиентское
  const { data: course, isPending, error } = useQuery({          // серверное
    queryKey: ["course", id],
    queryFn: () => fetch(`/api/courses/${id}`).then((r) => {
      if (!r.ok) throw new Error("Не удалось загрузить курс");
      return r.json();
    }),
    staleTime: 60_000,
  });
 
  if (isPending) return <p role="status">Загрузка…</p>;
  if (error) return <p role="alert">{error.message}</p>;
 
  return (
    <article>
      <h2>{course.title}</h2>
      <button onClick={() => setExpanded((v) => !v)}>Подробности</button>
      {expanded && <p>Уроков: {course.lessons}</p>}
    </article>
  );
}

Что библиотека берёт на себя по сравнению с useEffect + useState:

✔ кэш по ключу ["course", id] — второй компонент с тем же ключом не делает запрос
✔ отмена гонок при смене id
✔ состояния загрузки и ошибки
✔ повторы при ошибке сети
✔ фоновое обновление при возврате на вкладку
✔ инвалидация после мутации: queryClient.invalidateQueries({ queryKey: ["course", id] })

В Next.js App Router серверные данные чаще загружают прямо в Server Components, а на клиенте библиотека нужна для интерактивных сценариев (polling, бесконечная лента, оптимистичные обновления).

Сравнение

СвойствоКлиентскоеСерверное
Основной владелецИнтерфейсСервер или удаленная система
Типичные задачиВвод, вкладки, раскрытиеКеш, актуальность, загрузка, мутации
ИнструментыuseState, useReducer, storeЗагрузчик фреймворка, TanStack Query, SWR
Сохранность после reloadТребует отдельного решенияЗависит от хранения на сервере

Нюансы

Setter клиентского state также не меняет снимок мгновенно. Не стоит описывать разницу как «синхронный state против асинхронного».

Optimistic update временно меняет клиентскую копию до ответа сервера. Успех нужно подтвердить, ошибку - корректно обработать.

Что важно помнить

  • Серверное состояние асинхронно, разделяемо и может устареть без ведома клиента.
  • Для серверного состояния нужны кеш, дедупликация, фоновое обновление, инвалидация и повторы — это дают TanStack Query, SWR, RTK Query.
  • Не копируйте серверные данные в глобальный клиентский store вручную.
  • Клиентское состояние (UI-флаги, ввод) остается в useState, контексте или Zustand.

Мини-шпаргалка

  • UI-state принадлежит взаимодействию.
  • Server-state требует синхронизации с источником.
  • Кеш не гарантирует актуальность.
  • Одинаковое место хранения не означает одинаковые требования.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам