summaryrefslogtreecommitdiffstats
path: root/devtools/shared/content-observer.js
blob: c9f374096b6fe978227604e3e1889a917bb45192 (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
64
65
66
67
68
69
70
71
72
73
/* 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";

const EventEmitter = require("resource://devtools/shared/event-emitter.js");

/**
 * Handles adding an observer for the creation of content document globals,
 * event sent immediately after a web content document window has been set up,
 * but before any script code has been executed.
 */
function ContentObserver(targetActor) {
  this._contentWindow = targetActor.window;
  this._onContentGlobalCreated = this._onContentGlobalCreated.bind(this);
  this._onInnerWindowDestroyed = this._onInnerWindowDestroyed.bind(this);
  this.startListening();
}

module.exports.ContentObserver = ContentObserver;

ContentObserver.prototype = {
  /**
   * Starts listening for the required observer messages.
   */
  startListening() {
    Services.obs.addObserver(
      this._onContentGlobalCreated,
      "content-document-global-created"
    );
    Services.obs.addObserver(
      this._onInnerWindowDestroyed,
      "inner-window-destroyed"
    );
  },

  /**
   * Stops listening for the required observer messages.
   */
  stopListening() {
    Services.obs.removeObserver(
      this._onContentGlobalCreated,
      "content-document-global-created"
    );
    Services.obs.removeObserver(
      this._onInnerWindowDestroyed,
      "inner-window-destroyed"
    );
  },

  /**
   * Fired immediately after a web content document window has been set up.
   */
  _onContentGlobalCreated(subject) {
    if (subject == this._contentWindow) {
      EventEmitter.emit(this, "global-created", subject);
    }
  },

  /**
   * Fired when an inner window is removed from the backward/forward cache.
   */
  _onInnerWindowDestroyed(subject) {
    const id = subject.QueryInterface(Ci.nsISupportsPRUint64).data;
    EventEmitter.emit(this, "global-destroyed", id);
  },
};

// Utility functions.

ContentObserver.GetInnerWindowID = function (window) {
  return window.windowGlobalChild.innerWindowId;
};