Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

mobx-react-devtools

Package Overview
Dependencies
Maintainers
2
Versions
30
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

mobx-react-devtools

Dev-tools for MobX and React

  • 6.1.1
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
12K
decreased by-11.25%
Maintainers
2
Weekly downloads
 
Created
Source

mobx-react-devtools

DevTools for MobX to track the rendering behavior and data dependencies of your app.

MobX DevTools

The default position of the panel has been changed to bottom right. If you prefer top right like in the gif above, add position="topRight" to <DevTools />.

Installation

npm install --save-dev mobx-react-devtools

or

<script src="https://unpkg.com/mobx-react-devtools"></script>

Usage

Somewhere in your application, create a DevTools component:

import DevTools from 'mobx-react-devtools';

class MyApp extends React.Component {
  render() {
    return (
      <div>
        ...
        <DevTools />
      </div>
    );
  }
}

or

React.createElement(mobxDevtools.default)

Supported props:

  • highlightTimeout — number, default: 1500
  • noPanel — boolean, if set, do not render control panel, default: false
  • position — string (or object), topRight, bottomRight, bottomLeft or topLeft, default: bottomRight
  • className — string, className of control panel, default: not defined
  • style — object, inline style object of control panel, default: not defined

In order to be compatible with earlier versions of mobx-react-devtools it is also possible to assign position to an object containing inline styles. Using the dedicated style property is however recommended.

From there on, after each rendering a reactive components logs the following three metrics:

  1. Number of times the component did render so far
  2. The time spend in the render() method of a component
  3. The time spend from the start of the render() method until the changes are flushed to the DOM

For each component the color indicates roughly how long the coloring took. Rendering times are cumulative; they include time spend in the children

  • Green: less then 25 ms
  • Orange: less then 100 ms
  • Red: rendering for this component took more than 100ms

About log groups

Note that if logging is enabled, MobX actions and reactions will appear as collapsible groups inside the browsers console. Mind that any log statements that are printed during these (re)actions will appear inside those groups as well, so that you can exactly trace when they are triggered.

Configuration

import { configureDevtool } from 'mobx-react-devtools';

// Any configurations are optional
configureDevtool({
  // Turn on logging changes button programmatically:
  logEnabled: true,
  // Turn off displaying components updates button programmatically:
  updatesEnabled: false,
  // Log only changes of type `reaction`
  // (only affects top-level messages in console, not inside groups)
  logFilter: change => change.type === 'reaction',
});

There are also aliases for turning on/off devtools buttons:

import { setLogEnabled, setUpdatesEnabled, setGraphEnabled } from 'mobx-react-devtools';

setLogEnabled(true); // same as configureDevtool({ logEnabled: true });
setUpdatesEnabled(false); // same as configureDevtool({ updatesEnabled: false });
setGraphEnabled(false); // same as configureDevtool({ graphEnabled: false });

Custom panel design

import DevTools, { GraphControl, LogControl, UpdatesControl } from 'mobx-react-devtools';

class MyNiceButton extends React.Component {
  render() {
    const { active, onToggle, children } = this.props;
    return (
      <button onClick={onToggle}>
        {children}
        {active ? ' on' : ' off'}
      </button>
    );
  }
}

class MyApp extends React.Component {
  render() {
    return (
      <div>

        {/* Include somewhere with `noPanel` prop. Is needed to display updates and modals */}
        <DevTools noPanel />

        <div className="my-custom-devtools-panel-design">
          <GraphControl>
            {/* Must have only one child that takes props: `active` (bool), `onToggle` (func) */}
            <MyNiceButton>Graph</MyNiceButton>
          </GraphControl>
          <LogControl>
            {/* Must have only one child that takes props: `active` (bool), `onToggle` (func) */}
            <MyNiceButton>Log</MyNiceButton>
          </LogControl>
          <UpdatesControl>
            {/* Must have only one child that takes props: `active` (bool), `onToggle` (func) */}
            <MyNiceButton>Updates</MyNiceButton>
          </UpdatesControl>
        </div>
      </div>
    );
  }
}

Roadmap

  • Be able to turn dev-tools on and off at runtime
  • Select and log dependency tree of components
  • Visualize observer tree values
  • Be able to enable state change tracking from the extras module

Changelog

5.0.1

  • Updated peer dependencies for mobx-react@5.0.0

5.0.0

  • Upgraded to MobX 4.0.0

4.2.15

  • Fixed error on logging & expr

4.2.14

  • Stopped using mobx default export (#1043)

4.2.13

  • Fixed warning about calling PropTypes validators directly (#62)

4.2.12

  • Added react 15.5/16 support

4.2.11

  • Added MobX 3 support

4.2.9

  • Fixed typescript typings (#42)

4.2.8

  • Fixed typescript typings (#36)

4.2.7

  • Fixed passing highlightTimeout from DevTools (#41)

4.2.6

  • Fixed “max event listeners” warning when rendering in node.js ()

4.2.5

  • Added ability to filter displaying changes in console
  • Fixed submitting forms by DevTools panel buttons (#29)

4.2.4

  • Added ability to change buttons state programmatically(#27)

4.2.3

  • Made console colors lighter (#25)

4.2.2

  • Added modular devtools controls (#21)

4.0.5

  • Added Object.assign polyfill to avoid issues with server side rendering on old node vesions

4.0.2

  • Make sure AMD / root imports work (#12)
  • DevTools should now 'work' (not do anything) when used in Isomorphic rendering (#11)
  • Highlighting boxes now show up at the proper coordinates when using complex stacking contexts

4.0.1

  • Added typescript typings (see #6)
  • Use (fix) uglify, by @evoyy
  • Added option to customize the position of the toolbar (by @evoyy)

4.0.0

  • Upgraded to MobX 2.0 / MobX React 3.0

Keywords

FAQs

Package last updated on 05 Mar 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc