UNPKG

2.81 kBPlain TextView Raw
1/*
2 * Copyright 2020 Adobe. All rights reserved.
3 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License. You may obtain a copy
5 * of the License at http://www.apache.org/licenses/LICENSE-2.0
6 *
7 * Unless required by applicable law or agreed to in writing, software distributed under
8 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
9 * OF ANY KIND, either express or implied. See the License for the specific language
10 * governing permissions and limitations under the License.
11 */
12
13import {useCallback, useEffect, useRef} from 'react';
14
15interface GlobalListeners {
16 addGlobalListener<K extends keyof WindowEventMap>(el: Window, type: K, listener: (this: Document, ev: WindowEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void,
17 addGlobalListener<K extends keyof DocumentEventMap>(el: EventTarget, type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void,
18 addGlobalListener(el: EventTarget, type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void,
19 removeGlobalListener<K extends keyof DocumentEventMap>(el: EventTarget, type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void,
20 removeGlobalListener(el: EventTarget, type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void,
21 removeAllGlobalListeners(): void
22}
23
24export function useGlobalListeners(): GlobalListeners {
25 let globalListeners = useRef(new Map());
26 let addGlobalListener = useCallback((eventTarget, type, listener, options) => {
27 // Make sure we remove the listener after it is called with the `once` option.
28 let fn = options?.once ? (...args) => {
29 globalListeners.current.delete(listener);
30 listener(...args);
31 } : listener;
32 globalListeners.current.set(listener, {type, eventTarget, fn, options});
33 eventTarget.addEventListener(type, fn, options);
34 }, []);
35 let removeGlobalListener = useCallback((eventTarget, type, listener, options) => {
36 let fn = globalListeners.current.get(listener)?.fn || listener;
37 eventTarget.removeEventListener(type, fn, options);
38 globalListeners.current.delete(listener);
39 }, []);
40 let removeAllGlobalListeners = useCallback(() => {
41 globalListeners.current.forEach((value, key) => {
42 removeGlobalListener(value.eventTarget, value.type, key, value.options);
43 });
44 }, [removeGlobalListener]);
45
46
47 useEffect(() => {
48 return removeAllGlobalListeners;
49 }, [removeAllGlobalListeners]);
50
51 return {addGlobalListener, removeGlobalListener, removeAllGlobalListeners};
52}
53
\No newline at end of file