2022-06-15 04:53:56 +08:00
|
|
|
/*
|
2024-09-06 16:22:13 +08:00
|
|
|
Copyright 2022-2024 New Vector Ltd.
|
2022-06-15 04:53:56 +08:00
|
|
|
|
2024-09-06 16:22:13 +08:00
|
|
|
SPDX-License-Identifier: AGPL-3.0-only
|
|
|
|
Please see LICENSE in the repository root for full details.
|
2022-06-15 04:53:56 +08:00
|
|
|
*/
|
|
|
|
|
|
|
|
import { useEffect } from "react";
|
|
|
|
|
2022-10-14 21:40:21 +08:00
|
|
|
import type {
|
|
|
|
Listener,
|
|
|
|
ListenerMap,
|
|
|
|
TypedEventEmitter,
|
|
|
|
} from "matrix-js-sdk/src/models/typed-event-emitter";
|
|
|
|
|
2022-06-15 04:53:56 +08:00
|
|
|
// Shortcut for registering a listener on an EventTarget
|
2023-09-23 06:05:13 +08:00
|
|
|
export function useEventTarget<T extends Event>(
|
2022-11-29 05:15:47 +08:00
|
|
|
target: EventTarget | null | undefined,
|
2022-06-15 04:53:56 +08:00
|
|
|
eventType: string,
|
|
|
|
listener: (event: T) => void,
|
2023-10-11 22:42:04 +08:00
|
|
|
options?: AddEventListenerOptions,
|
2023-09-23 06:05:13 +08:00
|
|
|
): void {
|
2022-06-15 04:53:56 +08:00
|
|
|
useEffect(() => {
|
|
|
|
if (target) {
|
2023-06-30 23:43:28 +08:00
|
|
|
target.addEventListener(eventType, listener as EventListener, options);
|
2024-06-04 23:20:25 +08:00
|
|
|
return (): void =>
|
2023-06-30 23:43:28 +08:00
|
|
|
target.removeEventListener(
|
|
|
|
eventType,
|
|
|
|
listener as EventListener,
|
2023-10-11 22:42:04 +08:00
|
|
|
options,
|
2023-06-30 23:43:28 +08:00
|
|
|
);
|
2022-06-15 04:53:56 +08:00
|
|
|
}
|
|
|
|
}, [target, eventType, listener, options]);
|
2023-09-23 06:05:13 +08:00
|
|
|
}
|
2022-06-15 04:53:56 +08:00
|
|
|
|
2022-10-14 21:40:21 +08:00
|
|
|
// Shortcut for registering a listener on a TypedEventEmitter
|
2023-09-23 06:05:13 +08:00
|
|
|
export function useTypedEventEmitter<
|
2022-10-14 21:40:21 +08:00
|
|
|
Events extends string,
|
|
|
|
Arguments extends ListenerMap<Events>,
|
2023-10-11 22:42:04 +08:00
|
|
|
T extends Events,
|
2022-10-14 21:40:21 +08:00
|
|
|
>(
|
|
|
|
emitter: TypedEventEmitter<Events, Arguments>,
|
|
|
|
eventType: T,
|
2023-10-11 22:42:04 +08:00
|
|
|
listener: Listener<Events, Arguments, T>,
|
2023-09-23 06:05:13 +08:00
|
|
|
): void {
|
2022-10-14 21:40:21 +08:00
|
|
|
useEffect(() => {
|
|
|
|
emitter.on(eventType, listener);
|
2024-06-04 23:20:25 +08:00
|
|
|
return (): void => {
|
2022-10-14 21:40:21 +08:00
|
|
|
emitter.off(eventType, listener);
|
|
|
|
};
|
|
|
|
}, [emitter, eventType, listener]);
|
2023-09-23 06:05:13 +08:00
|
|
|
}
|