summaryrefslogtreecommitdiffstats
path: root/dom/webidl/EventTarget.webidl
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 /dom/webidl/EventTarget.webidl
parentInitial commit. (diff)
downloadfirefox-esr-upstream.tar.xz
firefox-esr-upstream.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r--dom/webidl/EventTarget.webidl73
1 files changed, 73 insertions, 0 deletions
diff --git a/dom/webidl/EventTarget.webidl b/dom/webidl/EventTarget.webidl
new file mode 100644
index 0000000000..5fe193a034
--- /dev/null
+++ b/dom/webidl/EventTarget.webidl
@@ -0,0 +1,73 @@
+/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* 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/.
+ *
+ * The origin of this IDL file is
+ * http://www.w3.org/TR/2012/WD-dom-20120105/
+ *
+ * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
+ * liability, trademark and document use rules apply.
+ */
+
+
+dictionary EventListenerOptions {
+ boolean capture = false;
+ /* Setting to true make the listener be added to the system group. */
+ [Func="ThreadSafeIsChromeOrUAWidget"]
+ boolean mozSystemGroup = false;
+};
+
+dictionary AddEventListenerOptions : EventListenerOptions {
+ boolean passive;
+ boolean once = false;
+ AbortSignal signal;
+ [ChromeOnly]
+ boolean wantUntrusted;
+};
+
+[Exposed=*]
+interface EventTarget {
+ [Throws]
+ constructor();
+
+ /* Passing null for wantsUntrusted means "default behavior", which
+ differs in content and chrome. In content that default boolean
+ value is true, while in chrome the default boolean value is
+ false. */
+ [Throws]
+ undefined addEventListener(DOMString type,
+ EventListener? listener,
+ optional (AddEventListenerOptions or boolean) options = {},
+ optional boolean? wantsUntrusted = null);
+ [Throws]
+ undefined removeEventListener(DOMString type,
+ EventListener? listener,
+ optional (EventListenerOptions or boolean) options = {});
+ [Throws, NeedsCallerType]
+ boolean dispatchEvent(Event event);
+};
+
+// Mozilla extensions for use by JS-implemented event targets to
+// implement on* properties.
+partial interface EventTarget {
+ // The use of [TreatNonCallableAsNull] here is a bit of a hack: it just makes
+ // the codegen check whether the type involved is either
+ // [TreatNonCallableAsNull] or [TreatNonObjectAsNull] and if it is handle it
+ // accordingly. In particular, it will NOT actually treat a non-null
+ // non-callable object as null here.
+ [ChromeOnly, Throws]
+ undefined setEventHandler(DOMString type,
+ [TreatNonCallableAsNull] EventHandler handler);
+
+ [ChromeOnly]
+ EventHandler getEventHandler(DOMString type);
+};
+
+// Mozilla extension to make firing events on event targets from
+// chrome easier. This returns the window which can be used to create
+// events to fire at this EventTarget, or null if there isn't one.
+partial interface EventTarget {
+ [ChromeOnly, Exposed=Window, BinaryName="ownerGlobalForBindings"]
+ readonly attribute WindowProxy? ownerGlobal;
+};