mirror of
https://github.com/reduxjs/redux-devtools.git
synced 2024-11-14 21:56:55 +03:00
175 lines
6.4 KiB
TypeScript
175 lines
6.4 KiB
TypeScript
|
import { Action, ActionCreator, StoreEnhancer, compose } from 'redux';
|
|||
|
|
|||
|
export interface EnhancerOptions {
|
|||
|
/**
|
|||
|
* the instance name to be showed on the monitor page. Default value is `document.title`.
|
|||
|
* If not specified and there's no document title, it will consist of `tabId` and `instanceId`.
|
|||
|
*/
|
|||
|
name?: string;
|
|||
|
/**
|
|||
|
* action creators functions to be available in the Dispatcher.
|
|||
|
*/
|
|||
|
actionCreators?: ActionCreator<any>[] | { [key: string]: ActionCreator<any> };
|
|||
|
/**
|
|||
|
* if more than one action is dispatched in the indicated interval, all new actions will be collected and sent at once.
|
|||
|
* It is the joint between performance and speed. When set to `0`, all actions will be sent instantly.
|
|||
|
* Set it to a higher value when experiencing perf issues (also `maxAge` to a lower value).
|
|||
|
*
|
|||
|
* @default 500 ms.
|
|||
|
*/
|
|||
|
latency?: number;
|
|||
|
/**
|
|||
|
* (> 1) - maximum allowed actions to be stored in the history tree. The oldest actions are removed once maxAge is reached. It's critical for performance.
|
|||
|
*
|
|||
|
* @default 50
|
|||
|
*/
|
|||
|
maxAge?: number;
|
|||
|
/**
|
|||
|
* - `undefined` - will use regular `JSON.stringify` to send data (it's the fast mode).
|
|||
|
* - `false` - will handle also circular references.
|
|||
|
* - `true` - will handle also date, regex, undefined, error objects, symbols, maps, sets and functions.
|
|||
|
* - object, which contains `date`, `regex`, `undefined`, `error`, `symbol`, `map`, `set` and `function` keys.
|
|||
|
* For each of them you can indicate if to include (by setting as `true`).
|
|||
|
* For `function` key you can also specify a custom function which handles serialization.
|
|||
|
* See [`jsan`](https://github.com/kolodny/jsan) for more details.
|
|||
|
*/
|
|||
|
serialize?:
|
|||
|
| boolean
|
|||
|
| {
|
|||
|
date?: boolean;
|
|||
|
regex?: boolean;
|
|||
|
undefined?: boolean;
|
|||
|
error?: boolean;
|
|||
|
symbol?: boolean;
|
|||
|
map?: boolean;
|
|||
|
set?: boolean;
|
|||
|
function?: boolean | Function;
|
|||
|
};
|
|||
|
/**
|
|||
|
* function which takes `action` object and id number as arguments, and should return `action` object back.
|
|||
|
*/
|
|||
|
actionSanitizer?: <A extends Action>(action: A, id: number) => A;
|
|||
|
/**
|
|||
|
* function which takes `state` object and index as arguments, and should return `state` object back.
|
|||
|
*/
|
|||
|
stateSanitizer?: <S>(state: S, index: number) => S;
|
|||
|
/**
|
|||
|
* *string or array of strings as regex* - actions types to be hidden / shown in the monitors (while passed to the reducers).
|
|||
|
* If `actionsWhitelist` specified, `actionsBlacklist` is ignored.
|
|||
|
*/
|
|||
|
actionsBlacklist?: string | string[];
|
|||
|
/**
|
|||
|
* *string or array of strings as regex* - actions types to be hidden / shown in the monitors (while passed to the reducers).
|
|||
|
* If `actionsWhitelist` specified, `actionsBlacklist` is ignored.
|
|||
|
*/
|
|||
|
actionsWhitelist?: string | string[];
|
|||
|
/**
|
|||
|
* called for every action before sending, takes `state` and `action` object, and returns `true` in case it allows sending the current data to the monitor.
|
|||
|
* Use it as a more advanced version of `actionsBlacklist`/`actionsWhitelist` parameters.
|
|||
|
*/
|
|||
|
predicate?: <S, A extends Action>(state: S, action: A) => boolean;
|
|||
|
/**
|
|||
|
* if specified as `false`, it will not record the changes till clicking on `Start recording` button.
|
|||
|
* Available only for Redux enhancer, for others use `autoPause`.
|
|||
|
*
|
|||
|
* @default true
|
|||
|
*/
|
|||
|
shouldRecordChanges?: boolean;
|
|||
|
/**
|
|||
|
* if specified, whenever clicking on `Pause recording` button and there are actions in the history log, will add this action type.
|
|||
|
* If not specified, will commit when paused. Available only for Redux enhancer.
|
|||
|
*
|
|||
|
* @default "@@PAUSED""
|
|||
|
*/
|
|||
|
pauseActionType?: string;
|
|||
|
/**
|
|||
|
* auto pauses when the extension’s window is not opened, and so has zero impact on your app when not in use.
|
|||
|
* Not available for Redux enhancer (as it already does it but storing the data to be sent).
|
|||
|
*
|
|||
|
* @default false
|
|||
|
*/
|
|||
|
autoPause?: boolean;
|
|||
|
/**
|
|||
|
* if specified as `true`, it will not allow any non-monitor actions to be dispatched till clicking on `Unlock changes` button.
|
|||
|
* Available only for Redux enhancer.
|
|||
|
*
|
|||
|
* @default false
|
|||
|
*/
|
|||
|
shouldStartLocked?: boolean;
|
|||
|
/**
|
|||
|
* if set to `false`, will not recompute the states on hot reloading (or on replacing the reducers). Available only for Redux enhancer.
|
|||
|
*
|
|||
|
* @default true
|
|||
|
*/
|
|||
|
shouldHotReload?: boolean;
|
|||
|
/**
|
|||
|
* if specified as `true`, whenever there's an exception in reducers, the monitors will show the error message, and next actions will not be dispatched.
|
|||
|
*
|
|||
|
* @default false
|
|||
|
*/
|
|||
|
shouldCatchErrors?: boolean;
|
|||
|
/**
|
|||
|
* If you want to restrict the extension, specify the features you allow.
|
|||
|
* If not specified, all of the features are enabled. When set as an object, only those included as `true` will be allowed.
|
|||
|
* Note that except `true`/`false`, `import` and `export` can be set as `custom` (which is by default for Redux enhancer), meaning that the importing/exporting occurs on the client side.
|
|||
|
* Otherwise, you'll get/set the data right from the monitor part.
|
|||
|
*/
|
|||
|
features?: {
|
|||
|
/**
|
|||
|
* start/pause recording of dispatched actions
|
|||
|
*/
|
|||
|
pause?: boolean;
|
|||
|
/**
|
|||
|
* lock/unlock dispatching actions and side effects
|
|||
|
*/
|
|||
|
lock?: boolean;
|
|||
|
/**
|
|||
|
* persist states on page reloading
|
|||
|
*/
|
|||
|
persist?: boolean;
|
|||
|
/**
|
|||
|
* export history of actions in a file
|
|||
|
*/
|
|||
|
export?: boolean | 'custom';
|
|||
|
/**
|
|||
|
* import history of actions from a file
|
|||
|
*/
|
|||
|
import?: boolean | 'custom';
|
|||
|
/**
|
|||
|
* jump back and forth (time travelling)
|
|||
|
*/
|
|||
|
jump?: boolean;
|
|||
|
/**
|
|||
|
* skip (cancel) actions
|
|||
|
*/
|
|||
|
skip?: boolean;
|
|||
|
/**
|
|||
|
* drag and drop actions in the history list
|
|||
|
*/
|
|||
|
reorder?: boolean;
|
|||
|
/**
|
|||
|
* dispatch custom actions or action creators
|
|||
|
*/
|
|||
|
dispatch?: boolean;
|
|||
|
/**
|
|||
|
* generate tests for the selected actions
|
|||
|
*/
|
|||
|
test?: boolean;
|
|||
|
};
|
|||
|
/**
|
|||
|
* Set to true or a stacktrace-returning function to record call stack traces for dispatched actions.
|
|||
|
* Defaults to false.
|
|||
|
*/
|
|||
|
trace?: boolean | (<A extends Action>(action: A) => string);
|
|||
|
/**
|
|||
|
* The maximum number of stack trace entries to record per action. Defaults to 10.
|
|||
|
*/
|
|||
|
traceLimit?: number;
|
|||
|
}
|
|||
|
|
|||
|
export function composeWithDevTools<StoreExt, StateExt>(
|
|||
|
...funcs: Array<StoreEnhancer<StoreExt>>
|
|||
|
): StoreEnhancer<StoreExt>;
|
|||
|
export function composeWithDevTools(options: EnhancerOptions): typeof compose;
|
|||
|
export function devToolsEnhancer(options: EnhancerOptions): StoreEnhancer<any>;
|