summaryrefslogtreecommitdiffstats
path: root/devtools/shared/commands/object/object-command.js
blob: 0396b6167ab4d4d7bbaecff4a04300e7e36b59e0 (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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
/* 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";

/**
 * The ObjectCommand helps inspecting and managing lifecycle
 * of all inspected JavaScript objects.
 */
class ObjectCommand {
  constructor({ commands, descriptorFront, watcherFront }) {
    this.#commands = commands;
  }
  #commands = null;

  /**
   * Release a set of object actors all at once.
   *
   * @param {Array<ObjectFront>} frontsToRelease
   *        List of fronts for the object to release.
   */
  async releaseObjects(frontsToRelease) {
    // @backward-compat { version 123 } A new Objects Manager front has a new "releaseActors" method.
    // Only supportsReleaseActors=true codepath can be kept once 123 is the release channel.
    const { supportsReleaseActors } = this.#commands.client.mainRoot.traits;

    // First group all object fronts per target
    const actorsPerTarget = new Map();
    const promises = [];
    for (const frontToRelease of frontsToRelease) {
      const { targetFront } = frontToRelease;
      // If the front is already destroyed, its target front will be nullified.
      if (!targetFront) {
        continue;
      }

      let actorIDsToRemove = actorsPerTarget.get(targetFront);
      if (!actorIDsToRemove) {
        actorIDsToRemove = [];
        actorsPerTarget.set(targetFront, actorIDsToRemove);
      }
      if (supportsReleaseActors) {
        actorIDsToRemove.push(frontToRelease.actorID);
        frontToRelease.destroy();
      } else {
        promises.push(frontToRelease.release());
      }
    }

    if (supportsReleaseActors) {
      // Then release all fronts by bulk per target
      for (const [targetFront, actorIDs] of actorsPerTarget) {
        const objectsManagerFront = await targetFront.getFront("objects-manager");
        promises.push(objectsManagerFront.releaseObjects(actorIDs));
      }
    }

    await Promise.all(promises);
  }
}

module.exports = ObjectCommand;