-
Notifications
You must be signed in to change notification settings - Fork 37
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Use EventTarget rather than the Node "events" module (#1188)
This should amount no meaningful change but is a useful preliminary to extracting the device code for reuse. Incorporates the only meaningful file from https://github.com/DerZade/typescript-event-target/ (with licence details) to save on the dependency.
- Loading branch information
1 parent
eded0a4
commit 506446c
Showing
26 changed files
with
436 additions
and
203 deletions.
There are no files selected for viewing
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,122 @@ | ||
| /** | ||
| * Copyright (c) 2022 Jonas "DerZade" Schade | ||
| * | ||
| * SPDX-License-Identifier: MIT | ||
| * | ||
| * https://github.com/DerZade/typescript-event-target/blob/master/src/TypedEventTarget.ts | ||
| */ | ||
|
|
||
| /** | ||
| * A function that can be passed to the `listener` parameter of {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}. | ||
| * | ||
| * @template M A map of event types to their respective event classes. | ||
| * @template T The type of event to listen for (has to be keyof `M`). | ||
| */ | ||
| export type TypedEventListener<M, T extends keyof M> = ( | ||
| evt: M[T] | ||
| ) => void | Promise<void>; | ||
|
|
||
| /** | ||
| * An object that can be passed to the `listener` parameter of {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}. | ||
| * | ||
| * @template M A map of event types to their respective event classes. | ||
| * @template T The type of event to listen for (has to be keyof `M`). | ||
| */ | ||
| export interface TypedEventListenerObject<M, T extends keyof M> { | ||
| handleEvent: (evt: M[T]) => void | Promise<void>; | ||
| } | ||
|
|
||
| /** | ||
| * Type of parameter `listener` in {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}. | ||
| * | ||
| * The object that receives a notification (an object that implements the Event interface) when an event of the specified type occurs. | ||
| * | ||
| * Can be either an object with a handleEvent() method, or a JavaScript function. | ||
| * | ||
| * @template M A map of event types to their respective event classes. | ||
| * @template T The type of event to listen for (has to be keyof `M`). | ||
| */ | ||
| export type TypedEventListenerOrEventListenerObject<M, T extends keyof M> = | ||
| | TypedEventListener<M, T> | ||
| | TypedEventListenerObject<M, T>; | ||
|
|
||
| type ValueIsEvent<T> = { | ||
| [key in keyof T]: Event; | ||
| }; | ||
|
|
||
| /** | ||
| * Typescript friendly version of {@link EventTarget} | ||
| * | ||
| * @template M A map of event types to their respective event classes. | ||
| * | ||
| * @example | ||
| * ```typescript | ||
| * interface MyEventMap { | ||
| * hello: Event; | ||
| * time: CustomEvent<number>; | ||
| * } | ||
| * | ||
| * const eventTarget = new TypedEventTarget<MyEventMap>(); | ||
| * | ||
| * eventTarget.addEventListener('time', (event) => { | ||
| * // event is of type CustomEvent<number> | ||
| * }); | ||
| * ``` | ||
| */ | ||
| export interface TypedEventTarget<M extends ValueIsEvent<M>> { | ||
| /** Appends an event listener for events whose type attribute value is type. | ||
| * The callback argument sets the callback that will be invoked when the event | ||
| * is dispatched. | ||
| * | ||
| * The options argument sets listener-specific options. For compatibility this | ||
| * can be a boolean, in which case the method behaves exactly as if the value | ||
| * was specified as options's capture. | ||
| * | ||
| * When set to true, options's capture prevents callback from being invoked | ||
| * when the event's eventPhase attribute value is BUBBLING_PHASE. When false | ||
| * (or not present), callback will not be invoked when event's eventPhase | ||
| * attribute value is CAPTURING_PHASE. Either way, callback will be invoked if | ||
| * event's eventPhase attribute value is AT_TARGET. | ||
| * | ||
| * When set to true, options's passive indicates that the callback will not | ||
| * cancel the event by invoking preventDefault(). This is used to enable | ||
| * performance optimizations described in § 2.8 Observing event listeners. | ||
| * | ||
| * When set to true, options's once indicates that the callback will only be | ||
| * invoked once after which the event listener will be removed. | ||
| * | ||
| * The event listener is appended to target's event listener list and is not | ||
| * appended if it has the same type, callback, and capture. */ | ||
| addEventListener: <T extends keyof M & string>( | ||
| type: T, | ||
| listener: TypedEventListenerOrEventListenerObject<M, T> | null, | ||
| options?: boolean | AddEventListenerOptions | ||
| ) => void; | ||
|
|
||
| /** Removes the event listener in target's event listener list with the same | ||
| * type, callback, and options. */ | ||
| removeEventListener: <T extends keyof M & string>( | ||
| type: T, | ||
| callback: TypedEventListenerOrEventListenerObject<M, T> | null, | ||
| options?: EventListenerOptions | boolean | ||
| ) => void; | ||
|
|
||
| /** | ||
| * Dispatches a synthetic event event to target and returns true if either | ||
| * event's cancelable attribute value is false or its preventDefault() method | ||
| * was not invoked, and false otherwise. | ||
| * @deprecated To ensure type safety use `dispatchTypedEvent` instead. | ||
| */ | ||
| dispatchEvent: (event: Event) => boolean; | ||
| } | ||
| // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging | ||
| export class TypedEventTarget<M extends ValueIsEvent<M>> extends EventTarget { | ||
| /** | ||
| * Dispatches a synthetic event event to target and returns true if either | ||
| * event's cancelable attribute value is false or its preventDefault() method | ||
| * was not invoked, and false otherwise. | ||
| */ | ||
| public dispatchTypedEvent<T extends keyof M>(_type: T, event: M[T]): boolean { | ||
| return super.dispatchEvent(event); | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.