ngrx-store-freeze

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #machine-learning #deep-learning #linux #macos #nodejs #awesome-list #pytorch #mcp #openai #open-source

ngrx-store-freeze

(★ 197)

@ngrx/store meta reducer that prevents state from being mutated.

File Explorer

Download Latest Version (.zip)

- docs.md
- index.ts
.gitignore
.npmignore
circle.yml
index.ts
LICENSE
package-lock.json
package.json
README.md
rollup.config.js
tsconfig.es6.json
tsconfig.json
tslint.json
yarn.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## ngrx-store-freeze

[![npm version](https://badge.fury.io/js/ngrx-store-freeze.svg)](https://badge.fury.io/js/ngrx-store-freeze)
[![CircleCI](https://circleci.com/gh/brandonroberts/ngrx-store-freeze/tree/master.svg?style=svg&circle-token=6ba0f6b74d2186f7896a58377b8607346c07cee6)](https://circleci.com/gh/brandonroberts/ngrx-store-freeze/tree/master)

ngrx-store-freeze is a meta-reducer that prevents state from being mutated

* Recursively freezes the **current state**, the dispatched **action payload** if provided and the **new state**.
* When mutation occurs, an exception will be thrown.
* Should be used **only in development** to ensure that the state remains immutable.

### Installation

```sh
npm i --save-dev ngrx-store-freeze
```

OR

```sh
yarn add ngrx-store-freeze --dev
```

### Setup

```ts
import { StoreModule, MetaReducer, ActionReducerMap } from '@ngrx/store';
import { storeFreeze } from 'ngrx-store-freeze';
import { environment } from '../environments/environment'; // Angular CLI environment

export interface State {
  // reducer interfaces
}

export const reducers: ActionReducerMap<State> = {
  // reducers
}

export const metaReducers: MetaReducer<State>[] = !environment.production ? [storeFreeze]: [];

@NgModule({
  imports: [
    StoreModule.forRoot(reducers, { metaReducers }),
  ]
})
export class AppModule {}
```

## Additional Documentation

* [Usage with `@ngrx/router-store`](./docs/docs.md#router-store-compatibility)

## Credits

[redux-freeze](https://github.com/buunguyen/redux-freeze) - Redux middleware that prevents state from being mutated  
[Attila Egyed](https://github.com/tsm91) - The original maintainer of this project

ngrx-store-freeze

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

ngrx-store-freeze

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README