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

Что такое middleware в Redux и listener middleware

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

Middleware — функция, которая встает между dispatch и reducer и может перехватить, изменить, задержать или дополнить каждый action: логировать, отправлять аналитику, выполнять асинхронную логику. Сигнатура — store => next => action => {}. В Redux Toolkit для побочных эффектов в ответ на actions рекомендуется createListenerMiddleware — более простая альтернатива redux-saga и redux-observable.

Вопрос

Что такое middleware в Redux и как он устроен? Как с помощью listener middleware реагировать на actions и чем он отличается от thunk и saga?

Как устроен middleware

import type { Middleware } from "@reduxjs/toolkit";
 
export const logger: Middleware = (store) => (next) => (action) => {
  console.log("dispatch", action);
  const result = next(action);              // передать дальше по цепочке → reducer
  console.log("next state", store.getState());
  return result;
};
dispatch(action) → middleware 1 → middleware 2 → ... → reducer → новый state

Подключение:

configureStore({
  reducer,
  middleware: (getDefaultMiddleware) => getDefaultMiddleware().concat(logger),
});

getDefaultMiddleware() уже содержит thunk и dev-проверки — не теряйте их, переопределяя массив целиком.

Listener middleware

import { createListenerMiddleware, isAnyOf } from "@reduxjs/toolkit";
 
export const listenerMiddleware = createListenerMiddleware();
 
// сохранять корзину в localStorage после любых изменений
listenerMiddleware.startListening({
  matcher: isAnyOf(itemAdded, itemRemoved, cartCleared),
  effect: (_action, listenerApi) => {
    const { cart } = listenerApi.getState() as RootState;
    localStorage.setItem("cart", JSON.stringify(cart.items));
  },
});
 
// поиск с debounce: отменяет предыдущий запуск
listenerMiddleware.startListening({
  actionCreator: searchChanged,
  effect: async (action, listenerApi) => {
    listenerApi.cancelActiveListeners();
    await listenerApi.delay(300);
    listenerApi.dispatch(fetchSearchResults(action.payload));
  },
});
configureStore({
  reducer,
  middleware: (gDM) => gDM().prepend(listenerMiddleware.middleware),
});

Способы указать, на что реагировать: actionCreator, type, matcher (isAnyOf, isFulfilled), predicate(action, currentState, previousState).

Thunk, listener, saga

ThunkListener middlewareredux-saga
Запускаетсяявным dispatch(thunk)автоматически в ответ на actionавтоматически в ответ на action
Синтаксисasync/awaitasync/awaitгенераторы
Отмена, debounceвручнуюcancelActiveListeners, delay, conditiontakeLatest, debounce
Порог входанизкийнизкийвысокий
Входит в RTKдаданет

Типичные задачи для middleware

  • логирование и отправка ошибок в Sentry;
  • аналитика по actions;
  • синхронизация с localStorage и между вкладками;
  • WebSocket: открыть соединение по action и диспатчить входящие сообщения;
  • реакция одной фичи на события другой без прямых зависимостей.

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

  • Middleware видит каждый action — держите его быстрым.
  • Обязательно вызывайте next(action), иначе action не дойдет до reducer.
  • Побочные эффекты — в middleware и thunk-ах, а не в reducers.
  • Listener middleware обычно подключают через prepend, чтобы он стоял раньше остальных.
  • redux-saga встречается в старых проектах; для нового кода RTK рекомендует listener middleware и RTK Query.

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

Middleware: store => next => action => { ...; return next(action) }, цепочка между dispatch и reducer. Подключение: getDefaultMiddleware().concat(...). Listener: createListenerMiddleware().startListening({ actionCreator | matcher | predicate, effect }), есть delay, cancelActiveListeners, condition.

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

Redux: Middleware, Redux Toolkit: createListenerMiddleware, Redux Toolkit: getDefaultMiddleware.

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

Поиск

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