12 - Strong Typing the State and Actions
In this section we explore Strongly Typing the State and Actions
The official docs say: The createAction function returns a function, that when called returns an object in the shape of the Action interface. The props method is used to define any additional metadata needed for the handling of the action. Action creators provide a consistent, type-safe way to construct an action that is being dispatched.
1. Add Login Action Creators
import { createAction, props } from '@ngrx/store';
import { Authenticate, User } from '@demo-app/data-models';
export enum AuthActionTypes {
Login = '[Auth Page] Login',
LoginSuccess = '[Auth API] Login Success',
LoginFail = '[Auth API] Login Fail'
}
export const login = createAction(
AuthActionTypes.Login,
props<{ payload: Authenticate }> ()
);
export const loginSuccess = createAction(
AuthActionTypes.LoginSuccess,
props<{ payload: User }>()
);
export const loginFailure = createAction(
AuthActionTypes.LoginFail,
props<{ payload: any }>()
);
Action Hygiene
Actions should capture unique events not commands
Try not to reuse actions and make generic actions
Suffix your Action types with their source so you know where they are dispatched from like
Login = '[Login Page] Login'
Let effects and reducers be the decision maker not the component and add multiple cases to a switch statement or effects.
Avoid action sub typing by adding conditional information to a property of an action payload by making multiple actions for each case. This makes it easier to test and avoids complicated conditional logic in effects and reducers.
Write actions first
2. Add default state and interface
Update state interface
//----- ABBREVIATED-----//
/**
* Interface for the 'Auth' data used in
* - AuthState, and
* - authReducer
*/
export interface AuthData {
loading: boolean;
user: User;
error: Error
}
/**
* Interface to the part of the Store containing AuthState
* and other information related to AuthData.
*/
export interface AuthState {
readonly auth: AuthData;
}
//----- ABBREVIATED-----//
Also, update the create reducer function to this:
//----- ABBREVIATED-----//
const authReducer = createReducer(
initialState,
on(AuthActions.login, (state) => ({ ...state, loading: true })),
on(AuthActions.loginSuccess, (state) => ({
...state,
user: AuthActions.loginSuccess,
loading: false,
})),
on(AuthActions.loginFailure, (state) => ({
...state,
user: null,
loading: false,
}))
);
//----- ABBREVIATED-----//
Last updated