summaryrefslogtreecommitdiffstats
path: root/devtools/client/inspector/flexbox/actions/flexbox-highlighter.js
blob: 487a4c3b1214a6b05ddd497d9da12ba4296efe27 (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 panel
 *
 * They provide a shortcut for React components to invoke the flexbox highlighter
 * without having to know where the highlighter exists.
 */

module.exports = {
  /**
   * Toggle the flexbox highlighter for the given node front.
   *
   * @param {NodeFront} nodeFront
   *        Node for which the highlighter should be toggled.
   * @param {String} reason
   *        Reason why the highlighter was toggled; used in telemetry.
   */
  toggleFlexboxHighlighter(nodeFront, reason) {
    return async thunkOptions => {
      const { inspector } = thunkOptions;
      if (!inspector || inspector._destroyed) {
        return;
      }

      await inspector.highlighters.toggleFlexboxHighlighter(nodeFront, reason);
    };
  },
};