NgRx on Redux-inspiroitu tilan hallintakirjasto Angularille. Se keskittää sovelluksen tilan yhteen muuttumattomaan store-varastoon, jossa on tiukka, ennustettava, yksisuuntainen tiedonkulku, joka on rakennettu RxJS:n päälle.
Component dispatches an ACTION →
REDUCER produces new state (pure function) →
STORE updates →
SELECTORS read state →
Component re-renders
(EFFECTS handle side effects like HTTP, dispatching new actions)
import { createAction, props } from "@ngrx/store";
export const loadUsers = createAction("[Users] Load");
export const loadUsersSuccess = createAction("[Users] Load Success", props<{ users: User[] }>());
import { createReducer, on } from "@ngrx/store";
export const usersReducer = createReducer(
initialState,
on(loadUsers, state => ({ ...state, loading: true })),
on(loadUsersSuccess, (state, { users }) => ({ ...state, users, loading: false })),
);
Reducerit ovat puhtaita — annetun nykyisen tilan ja toiminnon perusteella ne palauttavat täysin uuden tila-objektin (muuttumattomasti), eivätkä koskaan muuta vanhaa.
loadUsers$ = createEffect(() =>
this.actions$.pipe(
ofType(loadUsers),
switchMap(() =>
this.api.getUsers().pipe(
map(users => loadUsersSuccess({ users })) // dispatch success with the data
)
)
)
);
Efektit kuuntelevat toimintoja, suorittavat asynkronista työtä (kuten HTTP) ja lähettävät tulosasia — pitävät sivuvaikutukset komponenttien ja reducereiden ulkopuolella.
export const selectUsers = createSelector(selectUsersState, s => s.users); // memoized
// component
users$ = this.store.select(selectUsers);
load() { this.store.dispatch(loadUsers()); }
<li *ngFor="let u of users$ | async">{{ u.name }}</li>
✓ Large apps with lots of shared state across many components
✓ Complex state interactions, need for time-travel debugging / strict predictability
✗ Small/medium apps → it's heavy boilerplate; a service + signals/BehaviorSubject is simpler
(Huomautus: NgRx tarjoaa myös kevyemmän SignalStore:n ja ComponentStore:n vähemmän mallinnuskoodille.)
NgRx tuo Reduxin ennustettavan, keskitetyn, yksisuuntaisen tilan hallinnan Angulariin — arvokas suurille sovelluksille, joissa monet komponentit jakavat monimutkaista tilaa, ja joissa tiukka jäljitettävyys ja virheenkorjaus ovat tärkeitä.
Mutta se sisältää huomattavaa mallinnuskoodia, joten keskeinen arviointi on, milloin sitä käytetään (suuri/monimutkainen jaettu tila) verrattuna yksinkertaisempiin lähestymistapoihin (palvelut signaaleilla tai BehaviorSubject) pienemmille sovelluksille.
Toiminto→reducer→store→selector-kulun ja efektien ymmärtäminen sivuvaikutuksille on olennaista NgRx-koodipohjien kanssa työskentelyn kannalta.