Установка библиотеки Redux¶
Redux — это библиотека управления состоянием для JavaScript-приложений, разработанная Дэном Абрамовым и Эндрю Кларком и впервые выпущенная в 2015 году. Она основана на принципах Flux и иммутабельности данных и широко используется в экосистеме React, хотя применима и с другими библиотеками интерфейса. Установка Redux выполняется через пакетный менеджер npm или Yarn и включает базовую настройку хранилища (store), редьюсеров и подключение к приложению.
¶Способы установки
Redux распространяется как пакет в реестре npm. Для проектов на Node.js рекомендуется использовать npm или Yarn — оба менеджера поддерживают установку как глобально, так и локально в проекте.
¶Установка через npm
``bash npm install redux ``
Для React-приложений дополнительно устанавливается пакет react-redux, который предоставляет хуки и компоненты для связи хранилища с компонентами:
``bash npm install react-redux ``
¶Установка через Yarn
``bash yarn add redux yarn add react-redux ``
¶Redux Toolkit
С 2019 года команда Redux рекомендует использовать Redux Toolkit (RTK) — официальный набор утилит, упрощающий написание кода Redux и устраняющий типичные ошибки. Redux Toolkit включает в себя саму библиотеку Redux, поэтому отдельно устанавливать её не нужно:
``bash npm install @reduxjs/toolkit ``
или
``bash yarn add @reduxjs/toolkit ``
Redux Toolkit предоставляет функции configureStore, createSlice, createAsyncThunk и другие, которые значительно сокращают объём шаблонного кода.
¶Базовая настройка после установки
После установки пакетов необходимо создать хранилище, определить редьюсеры и подключить провайдер к корневому компоненту приложения.
¶Создание хранилища
С помощью Redux Toolkit:
```javascript import { configureStore } from '@reduxjs/toolkit'; import counterReducer from './features/counter/counterSlice';
export const store = configureStore({ reducer: { counter: counterReducer, }, }); ```
Без Redux Toolkit («классический» подход):
```javascript import { createStore, combineReducers } from 'redux';
const rootReducer = combineReducers({ counter: counterReducer, });
export const store = createStore(rootReducer); ```
¶Подключение к React
В корневом файле приложения (например, index.js) хранилище оборачивается в компонент Provider из react-redux:
```javascript import React from 'react'; import ReactDOM from 'react-dom/client'; import { Provider } from 'react-redux'; import { store } from './store'; import App from './App';
const root = ReactDOM.createRoot(document.getElementById('root')); root.render( <Provider store={store}> <App /> </Provider> ); ```
¶Использование в компонентах
Для чтения данных из хранилища в функциональных компонентах используется хук useSelector, для отправки действий — useDispatch:
```javascript import { useSelector, useDispatch } from 'react-redux'; import { increment } from './features/counter/counterSlice';
function Counter() { const count = useSelector((state) => state.counter.value); const dispatch = useDispatch();
return ( <button onClick={() => dispatch(increment())}> Значение: {count} </button> ); } ```
¶Типичные ошибки при установке
- Несовпадение версий. React Redux 8.x требует React 16.8.3 или выше (для использования хуков). При использовании более старых версий React следует установить react-redux@7.
- Отсутствие Provider. Без компонента
Provider, обёрнутого вокруг приложения, хукиuseSelectorиuseDispatchбудут выбрасывать ошибку. - Установка только redux без react-redux. Для React-приложений пакет react-redux обязателен — сам по себе Redux не предоставляет средств интеграции с React.
- Использование устаревшего синтаксиса. Метод
createStoreпомечен как deprecated в пользуconfigureStoreиз Redux Toolkit.
¶Проверка установки
Корректность установки можно проверить, импортировав пакет в консоли Node.js:
``bash node -e "console.log(require('redux').version)" ``
В React-приложении признак успешной настройки — отсутствие ошибок в консоли браузера и возможность диспатчить действия и читать состояние через хуки.
¶История и версии
Redux был представлен на конференции React Europe в 2015 году. С 2019 года развитие библиотеки сосредоточено вокруг Redux Toolkit, который стал стандартным способом работы с Redux. Версия 5.0 библиотеки выпущена в декабре 2023 года и включает улучшения типизации для TypeScript. Команда Redux активно развивает документацию на сайте redux.js.org.
