+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Sponsors
+
+Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/redux-devtools-extension#sponsor)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## License
+
+MIT
+
+## Created By
+
+If you like this, follow [@mdiordiev](https://twitter.com/mdiordiev) on twitter.
diff --git a/extension/SUMMARY.md b/extension/SUMMARY.md
new file mode 100644
index 00000000..542612fd
--- /dev/null
+++ b/extension/SUMMARY.md
@@ -0,0 +1 @@
+./docs/README.md
diff --git a/extension/appveyor.yml b/extension/appveyor.yml
new file mode 100644
index 00000000..884e5b13
--- /dev/null
+++ b/extension/appveyor.yml
@@ -0,0 +1,18 @@
+environment:
+ matrix:
+ - nodejs_version: '6'
+
+cache:
+ - '%LOCALAPPDATA%/Yarn'
+ - node_modules
+
+install:
+ - ps: Install-Product node $env:nodejs_version
+ - yarn install
+
+test_script:
+ - node --version
+ - yarn --version
+ - yarn test
+
+build: off
diff --git a/extension/book.json b/extension/book.json
new file mode 100644
index 00000000..d7f27743
--- /dev/null
+++ b/extension/book.json
@@ -0,0 +1,18 @@
+{
+ "gitbook": "3.2.2",
+ "title": "Redux DevTools Extension",
+ "plugins": ["edit-link", "prism", "-highlight", "github", "anchorjs"],
+ "pluginsConfig": {
+ "edit-link": {
+ "base": "https://github.com/zalmoxisus/redux-devtools-extension/tree/master",
+ "label": "Edit This Page"
+ },
+ "github": {
+ "url": "https://github.com/zalmoxisus/redux-devtools-extension/"
+ },
+ "sharing": {
+ "facebook": true,
+ "twitter": true
+ }
+ }
+}
diff --git a/extension/docs/API/Arguments.md b/extension/docs/API/Arguments.md
new file mode 100644
index 00000000..fe632424
--- /dev/null
+++ b/extension/docs/API/Arguments.md
@@ -0,0 +1,324 @@
+# Options
+
+Use with
+
+- `window.__REDUX_DEVTOOLS_EXTENSION__([options])`
+- `window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__([options])()`
+- `window.__REDUX_DEVTOOLS_EXTENSION__.connect([options])`
+- `redux-devtools-extension` npm package:
+
+```js
+import { composeWithDevTools } from 'redux-devtools-extension';
+
+const composeEnhancers = composeWithDevTools(options);
+const store = createStore(
+ reducer,
+ /* preloadedState, */ composeEnhancers(
+ applyMiddleware(...middleware)
+ // other store enhancers if any
+ )
+);
+```
+
+The `options` object is optional, and can include any of the following.
+
+### `name`
+
+_string_ - the instance name to be shown 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`.
+
+### `actionCreators`
+
+_array_ or _object_ - action creators functions to be available in the Dispatcher. See [the example](https://github.com/zalmoxisus/redux-devtools-extension/commit/477e69d8649dfcdc9bf84dd45605dab7d9775c03).
+
+### `latency`
+
+_number (in ms)_ - 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 is `500 ms`.
+
+### `maxAge`
+
+_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 is `50`.
+
+### `trace`
+
+_boolean_ or _function_ - if set to `true`, will include stack trace for every dispatched action, so you can see it in trace tab jumping directly to that part of code ([more details](../Features/Trace.md)). You can use a function (with action object as argument) which should return `new Error().stack` string, getting the stack outside of reducers. Default to `false`.
+
+### `traceLimit`
+
+_number_ - maximum stack trace frames to be stored (in case `trace` option was provided as `true`). By default it's `10`. Note that, because extension's calls are excluded, the resulted frames could be 1 less. If `trace` option is a function, `traceLimit` will have no effect, as it's supposed to be handled there.
+
+### `serialize`
+
+_boolean_ or _object_ which contains:
+
+- **options** `object or boolean`:
+
+ - `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, primitives, error objects, symbols, maps, sets and functions.
+ - object, which contains `date`, `regex`, `undefined`, `nan`, `infinity`, `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. Example:
+
+ ```js
+ const store = Redux.createStore(
+ reducer,
+ window.__REDUX_DEVTOOLS_EXTENSION__ &&
+ window.__REDUX_DEVTOOLS_EXTENSION__({
+ serialize: {
+ options: {
+ undefined: true,
+ function: function (fn) {
+ return fn.toString();
+ },
+ },
+ },
+ })
+ );
+ ```
+
+- **replacer** `function(key, value)` - [JSON `replacer` function](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#The_replacer_parameter) used for both actions and states stringify.
+
+ Example of usage with [mori data structures](https://github.com/swannodette/mori):
+
+ ```js
+ const store = Redux.createStore(
+ reducer,
+ window.__REDUX_DEVTOOLS_EXTENSION__ &&
+ window.__REDUX_DEVTOOLS_EXTENSION__({
+ serialize: {
+ replacer: (key, value) =>
+ value && mori.isMap(value) ? mori.toJs(value) : value,
+ },
+ })
+ );
+ ```
+
+ In addition, you can specify a data type by adding a [`__serializedType__`](https://github.com/zalmoxisus/remotedev-serialize/blob/master/helpers/index.js#L4) key. So you can deserialize it back while importing or persisting data. Moreover, it will also [show a nice preview showing the provided custom type](https://cloud.githubusercontent.com/assets/7957859/21814330/a17d556a-d761-11e6-85ef-159dd12f36c5.png):
+
+ ```js
+ const store = Redux.createStore(
+ reducer,
+ window.__REDUX_DEVTOOLS_EXTENSION__ &&
+ window.__REDUX_DEVTOOLS_EXTENSION__({
+ serialize: {
+ replacer: (key, value) => {
+ if (Immutable.List.isList(value)) {
+ // use your custom data type checker
+ return {
+ data: value.toArray(), // ImmutableJS custom method to get JS data as array
+ __serializedType__: 'ImmutableList', // mark you custom data type to show and retrieve back
+ };
+ }
+ },
+ },
+ })
+ );
+ ```
+
+- **reviver** `function(key, value)` - [JSON `reviver` function](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Using_the_reviver_parameter) used for parsing the imported actions and states. See [`remotedev-serialize`](https://github.com/zalmoxisus/remotedev-serialize/blob/master/immutable/serialize.js#L8-L41) as an example on how to serialize special data types and get them back:
+
+ ```js
+ const store = Redux.createStore(
+ reducer,
+ window.__REDUX_DEVTOOLS_EXTENSION__ &&
+ window.__REDUX_DEVTOOLS_EXTENSION__({
+ serialize: {
+ reviver: (key, value) => {
+ if (
+ typeof value === 'object' &&
+ value !== null &&
+ '__serializedType__' in value
+ ) {
+ switch (value.__serializedType__) {
+ case 'ImmutableList':
+ return Immutable.List(value.data);
+ }
+ }
+ },
+ },
+ })
+ );
+ ```
+
+- **immutable** `object` - automatically serialize/deserialize immutablejs via [remotedev-serialize](https://github.com/zalmoxisus/remotedev-serialize). Just pass the Immutable library like so:
+
+ ```js
+ import Immutable from 'immutable'; // https://facebook.github.io/immutable-js/
+ // ...
+ // Like above, only showing off compose this time. Reminder you might not want this in prod.
+ const composeEnhancers =
+ typeof window === 'object' &&
+ typeof window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__ !== 'undefined'
+ ? window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__({
+ serialize: {
+ immutable: Immutable,
+ },
+ })
+ : compose;
+ ```
+
+ It will support all ImmutableJS structures. You can even export them into a file and get them back. The only exception is `Record` class, for which you should pass in addition the references to your classes in `refs`.
+
+- **refs** `array` - ImmutableJS `Record` classes used to make possible restore its instances back when importing, persisting... Example of usage:
+
+ ```js
+ import Immutable from 'immutable';
+ // ...
+
+ const ABRecord = Immutable.Record({ a: 1, b: 2 });
+ const myRecord = new ABRecord({ b: 3 }); // used in the reducers
+
+ const store = createStore(
+ rootReducer,
+ window.__REDUX_DEVTOOLS_EXTENSION__ &&
+ window.__REDUX_DEVTOOLS_EXTENSION__({
+ serialize: {
+ immutable: Immutable,
+ refs: [ABRecord],
+ },
+ })
+ );
+ ```
+
+Also you can specify alternative values right in the state object (in the initial state of the reducer) by adding `toJSON` function:
+
+In the example bellow it will always send `{ component: '[React]' }`, regardless of the state's `component` value (useful when you don't want to send lots of unnecessary data):
+
+```js
+function component(
+ state = { component: null, toJSON: () => ({ component: '[React]' }) },
+ action
+) {
+ switch (action.type) {
+ case 'ADD_COMPONENT':
+ return { component: action.component };
+ default:
+ return state;
+ }
+}
+```
+
+You could also alter the value. For example when state is `{ count: 1 }`, we'll send `{ counter: 10 }` (notice we don't have an arrow function this time to use the object's `this`):
+
+```js
+function counter(
+ state = {
+ count: 0,
+ toJSON: function () {
+ return { conter: this.count * 10 };
+ },
+ },
+ action
+) {
+ switch (action.type) {
+ case 'INCREMENT':
+ return { count: state.count + 1 };
+ default:
+ return state;
+ }
+}
+```
+
+### `actionSanitizer` / `stateSanitizer`
+
+- **actionSanitizer** (_function_) - function which takes `action` object and id number as arguments, and should return `action` object back. See the example bellow.
+- **stateSanitizer** (_function_) - function which takes `state` object and index as arguments, and should return `state` object back.
+
+Example of usage:
+
+```js
+const actionSanitizer = (action) =>
+ action.type === 'FILE_DOWNLOAD_SUCCESS' && action.data
+ ? { ...action, data: '<
+
+### It shows only the `@@INIT` action or moving back and forth doesn't update the state
+
+Most likely you mutate the state. Check it by [adding `redux-immutable-state-invariant` middleware](https://github.com/zalmoxisus/redux-devtools-extension/blob/master/examples/counter/store/configureStore.js#L3).
+
+### @@INIT or REPLACE action resets the state of the app or last actions RE-APPLIED
+
+`@@redux/REPLACE` (or `@@INIT`) is used internally when the application is hot reloaded. When you use `store.replaceReducer` the effect will be the same as for hot-reloading, where the extension is recomputing all the history again. To avoid that set [`shouldHotReload`](/docs/API/Arguments.md#shouldhotreload) parameter to `false`.
+
+### It doesn't work with other store enhancers
+
+Usually the extension's store enhancer should be last in the compose. When you're using [`window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__`](/README.md#12-advanced-store-setup) or [`composeWithDevTools`](/README.md#13-use-redux-devtools-extension-package-from-npm) helper you don't have to worry about the enhancers order. However some enhancers ([like `redux-batched-subscribe`](https://github.com/zalmoxisus/redux-devtools-extension/issues/261)) also have this requirement to be the last in the compose. In this case you can use it like so:
+
+```js
+const store = createStore(
+ reducer,
+ preloadedState,
+ compose(
+ // applyMiddleware(thunk),
+ window.__REDUX_DEVTOOLS_EXTENSION__
+ ? window.__REDUX_DEVTOOLS_EXTENSION__()
+ : (noop) => noop,
+ batchedSubscribe(/* ... */)
+ )
+);
+```
+
+Where `batchedSubscribe` is `redux-batched-subscribe` store enhancer.
+
+### Excessive use of memory and CPU
+
+That is happening due to serialization of some huge objects included in the state or action. The solution is to [sanitize them](/docs/API/Arguments.md#actionsanitizer--statesanitizer).
+
+You can do that by including/omitting data containing specific values, having specific types... In the example below we're omitting parts of action and state objects with the key `data` (in case of action only when was dispatched action `FILE_DOWNLOAD_SUCCESS`):
+
+```js
+const actionSanitizer = (action) =>
+ action.type === 'FILE_DOWNLOAD_SUCCESS' && action.data
+ ? { ...action, data: '<+ Clicked: {counter} times {' '} + {' '} + {' '} + +
+ ); + } +} + +Counter.propTypes = { + increment: PropTypes.func.isRequired, + autoIncrement: PropTypes.func.isRequired, + incrementAsync: PropTypes.func.isRequired, + decrement: PropTypes.func.isRequired, + counter: PropTypes.number.isRequired, +}; + +export default Counter; diff --git a/extension/examples/counter/containers/App.js b/extension/examples/counter/containers/App.js new file mode 100644 index 00000000..47287ecf --- /dev/null +++ b/extension/examples/counter/containers/App.js @@ -0,0 +1,16 @@ +import { bindActionCreators } from 'redux'; +import { connect } from 'react-redux'; +import Counter from '../components/Counter'; +import * as CounterActions from '../actions/counter'; + +function mapStateToProps(state) { + return { + counter: state.counter, + }; +} + +function mapDispatchToProps(dispatch) { + return bindActionCreators(CounterActions, dispatch); +} + +export default connect(mapStateToProps, mapDispatchToProps)(Counter); diff --git a/extension/examples/counter/index.html b/extension/examples/counter/index.html new file mode 100644 index 00000000..0f963144 --- /dev/null +++ b/extension/examples/counter/index.html @@ -0,0 +1,10 @@ + + + ++ Clicked: {counter} times {' '} + +
+ ); + } +} + +export default Counter; diff --git a/extension/examples/react-counter-messaging/index.html b/extension/examples/react-counter-messaging/index.html new file mode 100644 index 00000000..f877ce0b --- /dev/null +++ b/extension/examples/react-counter-messaging/index.html @@ -0,0 +1,10 @@ + + + ++ Clicked: {value} times {' '} + {' '} + {' '} + +
+); + +Counter.propTypes = { + value: PropTypes.number.isRequired, + onIncrement: PropTypes.func.isRequired, + onDecrement: PropTypes.func.isRequired, + onIncrementAsync: PropTypes.func.isRequired, + onIncrementIfOdd: PropTypes.func.isRequired, +}; + +export default Counter; diff --git a/extension/examples/saga-counter/src/main.js b/extension/examples/saga-counter/src/main.js new file mode 100644 index 00000000..f8eedf95 --- /dev/null +++ b/extension/examples/saga-counter/src/main.js @@ -0,0 +1,43 @@ +import 'babel-polyfill'; + +import React from 'react'; +import ReactDOM from 'react-dom'; +import { createStore, applyMiddleware, compose } from 'redux'; +import createSagaMiddleware from 'redux-saga'; +// import sagaMonitor from './sagaMonitor' + +import Counter from './components/Counter'; +import reducer from './reducers'; +import rootSaga from './sagas'; + +const sagaMiddleware = createSagaMiddleware(/* {sagaMonitor} */); +const composeEnhancers = + (window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__ && + window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__({ + trace: true, + traceLimit: 25, + })) || + compose; +const store = createStore( + reducer, + composeEnhancers(applyMiddleware(sagaMiddleware)) +); +sagaMiddleware.run(rootSaga); + +const action = (type) => store.dispatch({ type }); + +function render() { + ReactDOM.render( +