summaryrefslogtreecommitdiffstats
path: root/devtools/shared/content-observer.js
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /devtools/shared/content-observer.js
parentInitial commit. (diff)
downloadfirefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz
firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'devtools/shared/content-observer.js')
-rw-r--r--devtools/shared/content-observer.js73
1 files changed, 73 insertions, 0 deletions
diff --git a/devtools/shared/content-observer.js b/devtools/shared/content-observer.js
new file mode 100644
index 0000000000..08271e4572
--- /dev/null
+++ b/devtools/shared/content-observer.js
@@ -0,0 +1,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, topic, data) {
+ if (subject == this._contentWindow) {
+ EventEmitter.emit(this, "global-created", subject);
+ }
+ },
+
+ /**
+ * Fired when an inner window is removed from the backward/forward cache.
+ */
+ _onInnerWindowDestroyed(subject, topic, data) {
+ const id = subject.QueryInterface(Ci.nsISupportsPRUint64).data;
+ EventEmitter.emit(this, "global-destroyed", id);
+ },
+};
+
+// Utility functions.
+
+ContentObserver.GetInnerWindowID = function (window) {
+ return window.windowGlobalChild.innerWindowId;
+};