Открыть сервисСервис

Установка библиотеки 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.

Заметили ошибку или не согласны с информацией в статье? Напишите нам support@bfometr.ru