document #on params

Author: zefir-git

src/Component.ts

@@ -109,7 +109,10 @@ export class Component<T extends HTMLElement = HTMLElement> extends ElementCompo
         return this;
     }
 
-    public override on<K extends keyof HTMLElementEventMap>(type: K, listener: (ev: HTMLElementEventMap[K], component: this) => any, options?: boolean | AddEventListenerOptions) {
-        return super.on(type as any, listener, options);
+    public override on<K extends keyof HTMLElementEventMap>(type: K, listener: (ev: HTMLElementEventMap[K], component: this) => any): typeof this;
+    public override on<K extends keyof HTMLElementEventMap>(type: K, listener: (ev: HTMLElementEventMap[K], component: this) => any, options: AddEventListenerOptions): typeof this;
+    public override on<K extends keyof HTMLElementEventMap>(type: K, listener: (ev: HTMLElementEventMap[K], component: this) => any, useCapture: boolean): typeof this;
+    public override on<K extends keyof HTMLElementEventMap>(type: K, listener: (ev: HTMLElementEventMap[K], component: this) => any, c?: boolean | AddEventListenerOptions): typeof this {
+        return super.on(type as any, listener, c as any);
     }
 }

src/ElementComponent.ts

@@ -159,15 +159,11 @@ export abstract class ElementComponent<T extends Element> extends NodeComponent<
         return this;
     }
 
-    /**
-     * Add event listener
-     * @param type
-     * @param listener
-     * @param options
-     */
-    public override on<K extends keyof ElementEventMap>(type: K, listener: (ev: ElementEventMap[K], component: this) => any, options?: boolean | AddEventListenerOptions) {
-        this.node.addEventListener(type, e => listener(e, this), options);
-        return this;
+    public override on<K extends keyof ElementEventMap>(type: K, listener: (ev: ElementEventMap[K], component: this) => any): typeof this;
+    public override on<K extends keyof ElementEventMap>(type: K, listener: (ev: ElementEventMap[K], component: this) => any, options: AddEventListenerOptions): typeof this;
+    public override on<K extends keyof ElementEventMap>(type: K, listener: (ev: ElementEventMap[K], component: this) => any, useCapture: boolean): typeof this;
+    public override on<K extends keyof ElementEventMap>(type: K, listener: (ev: ElementEventMap[K], component: this) => any, c?: boolean | AddEventListenerOptions): typeof this {
+        return super.on(type as any, listener, c as any);
     }
 
     /**

src/NodeComponent.ts

@@ -51,12 +51,26 @@ export abstract class NodeComponent<T extends Node> {
 
 	/**
 	 * Add event listener
-	 * @param type
-	 * @param listener
-	 * @param options
+	 * @param type A case-sensitive string representing the event type to listen for.
+	 * @param listener The function that is called when an event of the specified type occurs.
 	 */
-	public on(type: string, listener: (ev: Event, component: this) => any, options?: boolean | AddEventListenerOptions) {
-		this.node.addEventListener(type, e => listener(e, this), options);
-		return this;
-	}
+	public on(type: string, listener: (ev: Event, component: this) => any): typeof this;
+	/**
+	 * Add event listener
+	 * @param type A case-sensitive string representing the event type to listen for.
+	 * @param listener The function that is called when an event of the specified type occurs.
+	 * @param options An object that specifies characteristics about the event listener. See {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#options `options` on MDN}
+	 */
+	public on(type: string, listener: (ev: Event, component: this) => any, options: AddEventListenerOptions): typeof this;
+    /**
+     * Add event listener
+     * @param type A case-sensitive string representing the event type to listen for.
+     * @param listener The function that is called when an event of the specified type occurs.
+     * @param useCapture See {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#usecapture `useCapture` on MDN}
+     */
+    public on(type: string, listener: (ev: Event, component: this) => any, useCapture: boolean): typeof this;
+    public on(type: string, listener: (ev: Event, component: this) => any, c?: boolean | AddEventListenerOptions) {
+        this.node.addEventListener(type, e => listener(e, this), c);
+        return this;
+    }
 }