summaryrefslogtreecommitdiffstats
path: root/devtools/client/inspector/grids/actions/grid-highlighter.js
blob: 6706dc88cd1482562579dcd97878aea02e45f05e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

"use strict";

/**
 * This module exports thunks.
 * Thunks are functions that can be dispatched to the Inspector Redux store.
 *
 * These functions receive one object with options that contains:
 * - dispatch() => function to dispatch Redux actions to the store
 * - getState() => function to get the current state of the entire Inspector Redux store
 * - inspector => object instance of Inspector client
 *
 * They provide a shortcut for React components to invoke the box model highlighter
 * without having to know where the highlighter exists.
 */

module.exports = {
  /**
   * Show the grid highlighter for the given node front.
   *
   * @param {NodeFront} nodeFront
   *        Node that should be highlighted.
   * @param {Object} options
   *        Optional configuration options passed to the grid highlighter
   */
  showGridHighlighter(nodeFront, options = {}) {
    return async thunkOptions => {
      const { inspector } = thunkOptions;
      if (!inspector) {
        return;
      }

      await inspector.highlighters.showGridHighlighter(nodeFront, options);
    };
  },
};