ngrx-store-logger
v0.2.4
Published
Advanced logging middleware for @ngrx/store
Downloads
31,057
Maintainers
Readme
ngrx-store-logger
Advanced logging for @ngrx/store applications, ported from redux-logger.
Dependencies
ngrx-store-logger
depends on @ngrx/store and Angular 2+.
Usage
npm install ngrx-store-logger --save
UPDATED FOR NGRX 4
- Import
ngrx-store-logger
- Wrap in an exported function
- Include in your meta-reducers in
StoreModule.forRoot
call.
import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { StoreModule, ActionReducer } from '@ngrx/store';
import { storeLogger } from 'ngrx-store-logger';
import { reducers } from './reducers';
export function logger(reducer: ActionReducer<State>): any {
// default, no options
return storeLogger()(reducer);
}
export const metaReducers = environment.production ? [] : [logger];
@NgModule({
imports: [
BrowserModule,
StoreModule.forRoot(
reducers,
{metaReducers}
)
]
})
export class MyAppModule {}
API
storeLogger(options : LoggerOptions = {}) : Reducer
Initializes logger with appropriate options (logical defaults if no options supplied) Returns a meta-reducer
Arguments
options
(Object): Available logger options
Options
interface LoggerOptions {
level? : 'log' | 'console' | 'warn' | 'error' | 'info'; //default log
collapsed? : boolean; //Should log group be collapsed? default: false
duration? : boolean; //Print duration with action? default: true
timestamp? : boolean; //Print timestamp with action? default: true
filter?: {
whitelist?: string[], // Only print actions included in this list - has priority over blacklist
blacklist?: string[] // Only print actions that are NOT included in this list
}
stateTransformer? : (state : Object) => Object; //Transform state before print default: state => state
actionTransformer? : (actn : Object) => Object; //Transform action before print default: actn => actn
colors? : {
title: (action : Object) => string;
prevState: (prevState : Object) => string;
action: (action: Object) => string;
nextState: (nextState : Object) => string;
error: (error: any, prevState: Object) => string;
}
}
Filtering
Whitelist
Only actions included in the list will be printed Example:
const options: LoggerOptions = {
filter: {
whitelist: ['set-value']
}
}
storeLogger(options) : Reducer
With this setup, only action set-value will be logged
Blacklist
Action included in the blacklist will not be printed Example:
const options: LoggerOptions = {
filter: {
blacklist: ['set-value']
}
}
storeLogger(options) : Reducer
With this setup, all actions except set-value will be printed
Note: Whitelist takes precedence over blacklist. If both are defined, only whitelist will be considered