Extend EventTarget to support event bubbling

cjs/interface/event-target.js

@@ -7,20 +7,20 @@ const EventTarget = (m => /* c8 ignore start */ m.__esModule ? m.default : m /*
  * @implements globalThis.EventTarget
  */
 class DOMEventTarget extends EventTarget {
-  getParent() {
+  _getParent() {
     return null;
   }
 
   dispatchEvent(event) {
-    super.dispatchEvent(event);
+    const dispatched = super.dispatchEvent(event);
 
     // intentionally simplified, specs imply way more code: https://dom.spec.whatwg.org/#event-path
-    if (event.bubbles && !event._stopPropagationFlag) {
-      const parent = this.getParent();
+    if (dispatched && event.bubbles && !event._stopPropagationFlag) {
+      const parent = this._getParent();
       if (parent && parent.dispatchEvent) 
-        parent.dispatchEvent(event);
+        return parent.dispatchEvent(event);
     }
-    return true;
+    return dispatched;
   }
 }
 

cjs/interface/node.js

@@ -142,7 +142,7 @@ class Node extends EventTarget {
     return false;
   }
 
-  getParent() {
+  _getParent() {
     return this.parentNode;
   }
 

esm/interface/event-target.js

@@ -6,20 +6,20 @@ import EventTarget from '@ungap/event-target';
  * @implements globalThis.EventTarget
  */
 class DOMEventTarget extends EventTarget {
-  getParent() {
+  _getParent() {
     return null;
   }
 
   dispatchEvent(event) {
-    super.dispatchEvent(event);
+    const dispatched = super.dispatchEvent(event);
 
     // intentionally simplified, specs imply way more code: https://dom.spec.whatwg.org/#event-path
-    if (event.bubbles && !event._stopPropagationFlag) {
-      const parent = this.getParent();
+    if (dispatched && event.bubbles && !event._stopPropagationFlag) {
+      const parent = this._getParent();
       if (parent && parent.dispatchEvent) 
-        parent.dispatchEvent(event);
+        return parent.dispatchEvent(event);
     }
-    return true;
+    return dispatched;
   }
 }
 

esm/interface/node.js

@@ -141,7 +141,7 @@ export class Node extends EventTarget {
     return false;
   }
 
-  getParent() {
+  _getParent() {
     return this.parentNode;
   }
 

test/interface/event-target.js

@@ -30,7 +30,7 @@ eventTarget.removeEventListener('foo', basicHandler);
 eventTarget.dispatchEvent(new Event('foo'));
 assert(callCount, 1, 'basicHandler should not have been called after being removed');
 
-assert(eventTarget.getParent(), null, 'getParent should return null');
+assert(eventTarget._getParent(), null, 'getParent should return null');
 
 
 // check propagation now
@@ -75,3 +75,20 @@ containerTarget.addEventListener('click', basicHandler, { once: true });
 callCount = 0;
 buttonTarget.dispatchEvent(new Event('click', { bubbles: true }));
 assert(callCount, 1, 'listener should be called once before stopping bubbling');
+
+// check stop immediate propagation
+buttonTarget.addEventListener(
+  'click',
+  (event) => {
+    event.stopImmediatePropagation();
+    callCount++;
+  },
+  {
+    once: true,
+  },
+);
+containerTarget.addEventListener('click', basicHandler, { once: true });
+
+callCount = 0;
+buttonTarget.dispatchEvent(new Event('click', { bubbles: true }));
+assert(callCount, 1, 'listener should be called once before stopping bubbling');

types/interface/document.d.ts

@@ -221,10 +221,10 @@ export class Document extends NonElementParentNode implements globalThis.Documen
             isSameNode(node: any): boolean;
             compareDocumentPosition(target: any): number;
             isEqualNode(node: any): boolean;
-            getParent(): any;
+            _getParent(): any;
             getRootNode(): any;
             [PREV]: any;
-            dispatchEvent(event: any): boolean;
+            dispatchEvent(event: any): any;
         };
         readonly observedAttributes: any[];
         readonly ELEMENT_NODE: number;

types/interface/event-target.d.ts

@@ -3,6 +3,6 @@ export { DOMEventTarget as EventTarget };
  * @implements globalThis.EventTarget
  */
 declare class DOMEventTarget implements globalThis.EventTarget {
-    getParent(): any;
-    dispatchEvent(event: any): boolean;
+    _getParent(): any;
+    dispatchEvent(event: any): any;
 }

types/interface/image.d.ts

@@ -181,10 +181,10 @@ export function ImageClass(ownerDocument: any): {
         isSameNode(node: any): boolean;
         compareDocumentPosition(target: any): number;
         isEqualNode(node: any): boolean;
-        getParent(): any;
+        _getParent(): any;
         getRootNode(): any;
         [PREV]: any;
-        dispatchEvent(event: any): boolean;
+        dispatchEvent(event: any): any;
     };
     readonly observedAttributes: any[];
     readonly ELEMENT_NODE: number;