emr-bridge 2.0.2 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -0
- package/cjs/entries/index.d.ts +1 -0
- package/cjs/entries/index.js +19 -0
- package/cjs/errors.d.ts +18 -0
- package/cjs/errors.js +34 -1
- package/cjs/package.json +3 -0
- package/cjs/scripts/base-bridge.d.ts +15 -8
- package/cjs/scripts/base-bridge.js +88 -42
- package/cjs/scripts/helpers/entities-info.d.ts +20 -0
- package/cjs/scripts/helpers/entities-info.js +38 -0
- package/cjs/scripts/helpers/env.js +1 -1
- package/cjs/scripts/helpers/id.d.ts +9 -0
- package/cjs/scripts/helpers/id.js +15 -1
- package/cjs/scripts/helpers/index.d.ts +3 -0
- package/cjs/scripts/helpers/index.js +7 -1
- package/cjs/scripts/helpers/ipc-channel.d.ts +10 -0
- package/cjs/scripts/helpers/ipc-channel.js +73 -61
- package/cjs/scripts/helpers/ipc-event-in-main.d.ts +7 -1
- package/cjs/scripts/helpers/ipc-event-in-main.js +27 -2
- package/cjs/scripts/helpers/ipc-payload.d.ts +38 -0
- package/cjs/scripts/helpers/ipc-payload.js +82 -0
- package/cjs/scripts/helpers/ipc-result.d.ts +9 -1
- package/cjs/scripts/helpers/ipc-result.js +32 -9
- package/cjs/scripts/helpers/names.d.ts +20 -0
- package/cjs/scripts/helpers/names.js +77 -0
- package/cjs/scripts/helpers/transfer.d.ts +8 -0
- package/cjs/scripts/helpers/transfer.js +24 -10
- package/cjs/scripts/helpers/web-contents-events-container.d.ts +57 -8
- package/cjs/scripts/helpers/web-contents-events-container.js +150 -25
- package/cjs/scripts/main/publish.d.ts +2 -2
- package/cjs/scripts/main/publish.js +177 -78
- package/cjs/scripts/preload/bridge.d.ts +2 -2
- package/cjs/scripts/preload/bridge.js +7 -6
- package/cjs/scripts/preload/provider.js +113 -18
- package/cjs/scripts/renderer/bridge.js +5 -0
- package/cjs/scripts/renderer/tunnels.d.ts +19 -2
- package/cjs/scripts/renderer/tunnels.js +133 -32
- package/cjs/types.d.ts +4 -0
- package/esm/entries/index.d.ts +1 -0
- package/esm/entries/index.js +5 -1
- package/esm/errors.d.ts +18 -0
- package/esm/errors.js +30 -0
- package/esm/scripts/base-bridge.d.ts +15 -8
- package/esm/scripts/base-bridge.js +90 -44
- package/esm/scripts/helpers/entities-info.d.ts +20 -0
- package/esm/scripts/helpers/entities-info.js +35 -0
- package/esm/scripts/helpers/env.js +1 -1
- package/esm/scripts/helpers/id.d.ts +9 -0
- package/esm/scripts/helpers/id.js +15 -1
- package/esm/scripts/helpers/index.d.ts +3 -0
- package/esm/scripts/helpers/index.js +3 -0
- package/esm/scripts/helpers/ipc-channel.d.ts +10 -0
- package/esm/scripts/helpers/ipc-channel.js +74 -63
- package/esm/scripts/helpers/ipc-event-in-main.d.ts +7 -1
- package/esm/scripts/helpers/ipc-event-in-main.js +24 -2
- package/esm/scripts/helpers/ipc-payload.d.ts +38 -0
- package/esm/scripts/helpers/ipc-payload.js +79 -0
- package/esm/scripts/helpers/ipc-result.d.ts +9 -1
- package/esm/scripts/helpers/ipc-result.js +32 -9
- package/esm/scripts/helpers/names.d.ts +20 -0
- package/esm/scripts/helpers/names.js +74 -0
- package/esm/scripts/helpers/transfer.d.ts +8 -0
- package/esm/scripts/helpers/transfer.js +24 -10
- package/esm/scripts/helpers/web-contents-events-container.d.ts +57 -8
- package/esm/scripts/helpers/web-contents-events-container.js +150 -25
- package/esm/scripts/main/publish.d.ts +2 -2
- package/esm/scripts/main/publish.js +179 -80
- package/esm/scripts/preload/bridge.d.ts +2 -2
- package/esm/scripts/preload/bridge.js +8 -7
- package/esm/scripts/preload/provider.js +114 -19
- package/esm/scripts/renderer/bridge.js +5 -0
- package/esm/scripts/renderer/tunnels.d.ts +19 -2
- package/esm/scripts/renderer/tunnels.js +135 -35
- package/esm/types.d.ts +4 -0
- package/package.json +35 -13
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { IRequest, IResult } from '../../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Хелпер для безопасного разбора данных, пришедших по IPC.
|
|
4
|
+
*
|
|
5
|
+
* Любые данные из IPC считаются недоверенными: неверный формат
|
|
6
|
+
* не должен приводить к исключению в обработчике main/preload.
|
|
7
|
+
*/
|
|
8
|
+
export default class IpcPayload {
|
|
9
|
+
/**
|
|
10
|
+
* Разобрать запрос.
|
|
11
|
+
* @param payload - Данные из IPC.
|
|
12
|
+
* @returns Запрос или `null`, если формат неверен.
|
|
13
|
+
*/
|
|
14
|
+
static request(payload: unknown): IRequest | null;
|
|
15
|
+
/**
|
|
16
|
+
* Разобрать результат.
|
|
17
|
+
* @param payload - Данные из IPC.
|
|
18
|
+
* @returns Результат или `null`, если формат неверен.
|
|
19
|
+
*/
|
|
20
|
+
static result(payload: unknown): IResult | null;
|
|
21
|
+
/**
|
|
22
|
+
* Получить имя события из данных регистрации.
|
|
23
|
+
* @param payload - Данные из IPC.
|
|
24
|
+
* @returns Имя события или `null`.
|
|
25
|
+
*/
|
|
26
|
+
static eventName(payload: unknown): string | null;
|
|
27
|
+
/**
|
|
28
|
+
* Получить тип регистрации события.
|
|
29
|
+
* @param payload - Данные из IPC.
|
|
30
|
+
* @returns Тип регистрации.
|
|
31
|
+
*/
|
|
32
|
+
static eventType(payload: unknown): 'on' | 'once';
|
|
33
|
+
/**
|
|
34
|
+
* Является ли значение обычным объектом.
|
|
35
|
+
* @param value - Значение.
|
|
36
|
+
*/
|
|
37
|
+
private static isObject;
|
|
38
|
+
}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для безопасного разбора данных, пришедших по IPC.
|
|
3
|
+
*
|
|
4
|
+
* Любые данные из IPC считаются недоверенными: неверный формат
|
|
5
|
+
* не должен приводить к исключению в обработчике main/preload.
|
|
6
|
+
*/
|
|
7
|
+
export default class IpcPayload {
|
|
8
|
+
/**
|
|
9
|
+
* Разобрать запрос.
|
|
10
|
+
* @param payload - Данные из IPC.
|
|
11
|
+
* @returns Запрос или `null`, если формат неверен.
|
|
12
|
+
*/
|
|
13
|
+
static request(payload) {
|
|
14
|
+
if (!IpcPayload.isObject(payload)) {
|
|
15
|
+
return null;
|
|
16
|
+
}
|
|
17
|
+
if (!Array.isArray(payload.args)) {
|
|
18
|
+
return null;
|
|
19
|
+
}
|
|
20
|
+
if (payload.id !== undefined && typeof payload.id !== 'string') {
|
|
21
|
+
return null;
|
|
22
|
+
}
|
|
23
|
+
return {
|
|
24
|
+
args: payload.args,
|
|
25
|
+
id: payload.id
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Разобрать результат.
|
|
30
|
+
* @param payload - Данные из IPC.
|
|
31
|
+
* @returns Результат или `null`, если формат неверен.
|
|
32
|
+
*/
|
|
33
|
+
static result(payload) {
|
|
34
|
+
if (!IpcPayload.isObject(payload)) {
|
|
35
|
+
return null;
|
|
36
|
+
}
|
|
37
|
+
if (payload.error !== undefined && typeof payload.error !== 'string') {
|
|
38
|
+
return null;
|
|
39
|
+
}
|
|
40
|
+
if (payload.promiseChannel !== undefined && typeof payload.promiseChannel !== 'string') {
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
if (payload.id !== undefined && typeof payload.id !== 'string') {
|
|
44
|
+
return null;
|
|
45
|
+
}
|
|
46
|
+
return {
|
|
47
|
+
value: payload.value,
|
|
48
|
+
error: payload.error,
|
|
49
|
+
promiseChannel: payload.promiseChannel,
|
|
50
|
+
id: payload.id
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Получить имя события из данных регистрации.
|
|
55
|
+
* @param payload - Данные из IPC.
|
|
56
|
+
* @returns Имя события или `null`.
|
|
57
|
+
*/
|
|
58
|
+
static eventName(payload) {
|
|
59
|
+
if (!IpcPayload.isObject(payload) || typeof payload.value !== 'string' || payload.value.length === 0) {
|
|
60
|
+
return null;
|
|
61
|
+
}
|
|
62
|
+
return payload.value;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Получить тип регистрации события.
|
|
66
|
+
* @param payload - Данные из IPC.
|
|
67
|
+
* @returns Тип регистрации.
|
|
68
|
+
*/
|
|
69
|
+
static eventType(payload) {
|
|
70
|
+
return IpcPayload.isObject(payload) && payload.type === 'once' ? 'once' : 'on';
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Является ли значение обычным объектом.
|
|
74
|
+
* @param value - Значение.
|
|
75
|
+
*/
|
|
76
|
+
static isObject(value) {
|
|
77
|
+
return typeof value === 'object' && value !== null;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
@@ -22,5 +22,13 @@ export default class IpcResult {
|
|
|
22
22
|
* @param id - Уникальный идентификатор.
|
|
23
23
|
* @returns Результат с ошибкой.
|
|
24
24
|
*/
|
|
25
|
-
static createWithError(error?:
|
|
25
|
+
static createWithError(error?: unknown, id?: string): IResult;
|
|
26
|
+
/**
|
|
27
|
+
* Привести брошенное значение к строке.
|
|
28
|
+
*
|
|
29
|
+
* Ошибкой может быть что угодно (`throw null`, строка, объект),
|
|
30
|
+
* поэтому сериализация не должна сама бросать исключение.
|
|
31
|
+
* @param error - Брошенное значение.
|
|
32
|
+
*/
|
|
33
|
+
private static stringifyError;
|
|
26
34
|
}
|
|
@@ -18,7 +18,10 @@ export default class IpcResult {
|
|
|
18
18
|
* @returns Результат со значением.
|
|
19
19
|
*/
|
|
20
20
|
static createWithValue(value, id) {
|
|
21
|
-
|
|
21
|
+
const transferable = Transfer.toTransferable(value);
|
|
22
|
+
return id === undefined
|
|
23
|
+
? { value: transferable }
|
|
24
|
+
: { value: transferable, id };
|
|
22
25
|
}
|
|
23
26
|
/**
|
|
24
27
|
* Создать результат с ошибкой.
|
|
@@ -27,16 +30,36 @@ export default class IpcResult {
|
|
|
27
30
|
* @returns Результат с ошибкой.
|
|
28
31
|
*/
|
|
29
32
|
static createWithError(error, id) {
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
+
const message = IpcResult.stringifyError(error);
|
|
34
|
+
return id === undefined
|
|
35
|
+
? { error: message }
|
|
36
|
+
: { error: message, id };
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Привести брошенное значение к строке.
|
|
40
|
+
*
|
|
41
|
+
* Ошибкой может быть что угодно (`throw null`, строка, объект),
|
|
42
|
+
* поэтому сериализация не должна сама бросать исключение.
|
|
43
|
+
* @param error - Брошенное значение.
|
|
44
|
+
*/
|
|
45
|
+
static stringifyError(error) {
|
|
46
|
+
if (error === undefined || error === null) {
|
|
47
|
+
return 'Unknown error';
|
|
48
|
+
}
|
|
49
|
+
if (typeof error === 'string') {
|
|
50
|
+
return error;
|
|
33
51
|
}
|
|
34
|
-
|
|
35
|
-
|
|
52
|
+
if (error instanceof Error) {
|
|
53
|
+
return error.stack ?? error.message;
|
|
36
54
|
}
|
|
37
|
-
|
|
38
|
-
|
|
55
|
+
if (typeof error === 'object') {
|
|
56
|
+
try {
|
|
57
|
+
return JSON.stringify(error) ?? String(error);
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
return String(error);
|
|
61
|
+
}
|
|
39
62
|
}
|
|
40
|
-
return
|
|
63
|
+
return String(error);
|
|
41
64
|
}
|
|
42
65
|
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для проверки имён сущностей и событий.
|
|
3
|
+
*/
|
|
4
|
+
export default class Names {
|
|
5
|
+
/**
|
|
6
|
+
* Зарезервировано ли имя для API моста.
|
|
7
|
+
* @param name - Имя.
|
|
8
|
+
*/
|
|
9
|
+
static isReserved(name: string): boolean;
|
|
10
|
+
/**
|
|
11
|
+
* Проверить имя публикуемой сущности.
|
|
12
|
+
* @param name - Имя.
|
|
13
|
+
*/
|
|
14
|
+
static validateEntity(name: unknown): asserts name is string;
|
|
15
|
+
/**
|
|
16
|
+
* Проверить имя события.
|
|
17
|
+
* @param name - Имя.
|
|
18
|
+
*/
|
|
19
|
+
static validateEvent(name: unknown): asserts name is string;
|
|
20
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { InvalidEntityNameError, InvalidEventNameError } from '../../errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Максимальная длина имени публикуемой сущности.
|
|
4
|
+
*/
|
|
5
|
+
const MAX_ENTITY_NAME_LENGTH = 256;
|
|
6
|
+
/**
|
|
7
|
+
* Максимальная длина имени события.
|
|
8
|
+
*/
|
|
9
|
+
const MAX_EVENT_NAME_LENGTH = 1024;
|
|
10
|
+
/**
|
|
11
|
+
* Имена, которые нельзя использовать для сущностей моста.
|
|
12
|
+
*
|
|
13
|
+
* Часть из них уже занята API моста, часть может сломать объект
|
|
14
|
+
* (например, `then` делает мост "thenable", а `__proto__` меняет прототип).
|
|
15
|
+
*/
|
|
16
|
+
const RESERVED_ENTITY_NAMES = new Set([
|
|
17
|
+
'as',
|
|
18
|
+
'emit',
|
|
19
|
+
'on',
|
|
20
|
+
'once',
|
|
21
|
+
'call',
|
|
22
|
+
'returns',
|
|
23
|
+
'then',
|
|
24
|
+
'catch',
|
|
25
|
+
'finally',
|
|
26
|
+
'constructor',
|
|
27
|
+
'prototype',
|
|
28
|
+
'__proto__',
|
|
29
|
+
'__defineGetter__',
|
|
30
|
+
'__defineSetter__',
|
|
31
|
+
'__lookupGetter__',
|
|
32
|
+
'__lookupSetter__',
|
|
33
|
+
'hasOwnProperty',
|
|
34
|
+
'isPrototypeOf',
|
|
35
|
+
'propertyIsEnumerable',
|
|
36
|
+
'toLocaleString',
|
|
37
|
+
'toString',
|
|
38
|
+
'valueOf',
|
|
39
|
+
'toJSON',
|
|
40
|
+
'inspect'
|
|
41
|
+
]);
|
|
42
|
+
/**
|
|
43
|
+
* Хелпер для проверки имён сущностей и событий.
|
|
44
|
+
*/
|
|
45
|
+
export default class Names {
|
|
46
|
+
/**
|
|
47
|
+
* Зарезервировано ли имя для API моста.
|
|
48
|
+
* @param name - Имя.
|
|
49
|
+
*/
|
|
50
|
+
static isReserved(name) {
|
|
51
|
+
return RESERVED_ENTITY_NAMES.has(name);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Проверить имя публикуемой сущности.
|
|
55
|
+
* @param name - Имя.
|
|
56
|
+
*/
|
|
57
|
+
static validateEntity(name) {
|
|
58
|
+
if (typeof name !== 'string' || name.length === 0 || name.length > MAX_ENTITY_NAME_LENGTH) {
|
|
59
|
+
throw new InvalidEntityNameError(name);
|
|
60
|
+
}
|
|
61
|
+
if (RESERVED_ENTITY_NAMES.has(name)) {
|
|
62
|
+
throw new InvalidEntityNameError(name, true);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Проверить имя события.
|
|
67
|
+
* @param name - Имя.
|
|
68
|
+
*/
|
|
69
|
+
static validateEvent(name) {
|
|
70
|
+
if (typeof name !== 'string' || name.length === 0 || name.length > MAX_EVENT_NAME_LENGTH) {
|
|
71
|
+
throw new InvalidEventNameError(name);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
@@ -22,6 +22,9 @@ export default class Transfer {
|
|
|
22
22
|
static toTransferable<T>(value: T): ISnapshotValue | T;
|
|
23
23
|
/**
|
|
24
24
|
* Является ли переданное по IPC значение снимком.
|
|
25
|
+
*
|
|
26
|
+
* Проверяются собственные свойства, а не унаследованные, и допускаются
|
|
27
|
+
* любые falsy-снимки (`0`, `false`, `''`, `null`).
|
|
25
28
|
* @param value - Значение из IPC.
|
|
26
29
|
*/
|
|
27
30
|
static isSnapshotValue(value: unknown): value is ISnapshotValue;
|
|
@@ -30,4 +33,9 @@ export default class Transfer {
|
|
|
30
33
|
* @param value - Значение.
|
|
31
34
|
*/
|
|
32
35
|
static isHasSnapshot(value: unknown): value is IHasSnapshot;
|
|
36
|
+
/**
|
|
37
|
+
* Является ли значение обещанием (или "thenable").
|
|
38
|
+
* @param value - Значение.
|
|
39
|
+
*/
|
|
40
|
+
static isPromiseLike<T = unknown>(value: unknown): value is PromiseLike<T>;
|
|
33
41
|
}
|
|
@@ -31,24 +31,38 @@ export default class Transfer {
|
|
|
31
31
|
}
|
|
32
32
|
/**
|
|
33
33
|
* Является ли переданное по IPC значение снимком.
|
|
34
|
+
*
|
|
35
|
+
* Проверяются собственные свойства, а не унаследованные, и допускаются
|
|
36
|
+
* любые falsy-снимки (`0`, `false`, `''`, `null`).
|
|
34
37
|
* @param value - Значение из IPC.
|
|
35
38
|
*/
|
|
36
39
|
static isSnapshotValue(value) {
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
&& value
|
|
42
|
-
&&
|
|
40
|
+
if (typeof value !== 'object' || value === null) {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
return (Object.prototype.hasOwnProperty.call(value, '__type__')
|
|
44
|
+
&& Object.prototype.hasOwnProperty.call(value, '__snapshot__')
|
|
45
|
+
&& value.__type__ === 'snapshot');
|
|
43
46
|
}
|
|
44
47
|
/**
|
|
45
48
|
* Может ли значение вернуть снимок.
|
|
46
49
|
* @param value - Значение.
|
|
47
50
|
*/
|
|
48
51
|
static isHasSnapshot(value) {
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
52
|
+
if (typeof value !== 'object' || value === null) {
|
|
53
|
+
return false;
|
|
54
|
+
}
|
|
55
|
+
const candidate = value;
|
|
56
|
+
return (typeof candidate.takeSnapshot === 'function'
|
|
57
|
+
&& typeof candidate.updateFromSnapshot === 'function');
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Является ли значение обещанием (или "thenable").
|
|
61
|
+
* @param value - Значение.
|
|
62
|
+
*/
|
|
63
|
+
static isPromiseLike(value) {
|
|
64
|
+
return (typeof value === 'object'
|
|
65
|
+
&& value !== null
|
|
66
|
+
&& typeof value.then === 'function');
|
|
53
67
|
}
|
|
54
68
|
}
|
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
import type { WebContents } from 'electron';
|
|
2
2
|
/**
|
|
3
3
|
* Обёртка над стандартным `WebContents`, позволяющая использовать события.
|
|
4
|
+
*
|
|
5
|
+
* Хранит только живые `WebContents` и удаляет опустевшие события,
|
|
6
|
+
* чтобы долгоживущий main процесс не накапливал мусор.
|
|
4
7
|
*/
|
|
5
8
|
export default class WebContentsEventContainer {
|
|
6
9
|
/**
|
|
7
|
-
*
|
|
10
|
+
* Контейнеры событий.
|
|
8
11
|
*/
|
|
9
|
-
private containers;
|
|
12
|
+
private readonly containers;
|
|
10
13
|
/**
|
|
11
14
|
* Добавить многоразового отправителя для события.
|
|
12
15
|
* @param event - Имя события.
|
|
@@ -19,10 +22,22 @@ export default class WebContentsEventContainer {
|
|
|
19
22
|
* @param sender - Отправитель.
|
|
20
23
|
*/
|
|
21
24
|
addOnce(event: string, sender: WebContents): void;
|
|
25
|
+
/**
|
|
26
|
+
* Удалить одну подписку многоразового отправителя.
|
|
27
|
+
* @param event - Имя события.
|
|
28
|
+
* @param sender - Отправитель.
|
|
29
|
+
*/
|
|
30
|
+
removeOn(event: string, sender: WebContents): void;
|
|
31
|
+
/**
|
|
32
|
+
* Удалить одну подписку одноразового отправителя.
|
|
33
|
+
* @param event - Имя события.
|
|
34
|
+
* @param sender - Отправитель.
|
|
35
|
+
*/
|
|
36
|
+
removeOnce(event: string, sender: WebContents): void;
|
|
22
37
|
/**
|
|
23
38
|
* Получить многоразовых отправителей для события.
|
|
24
39
|
* @param event - Имя события.
|
|
25
|
-
* @returns
|
|
40
|
+
* @returns Многоразовые отправители для события.
|
|
26
41
|
*/
|
|
27
42
|
getOn(event: string): WebContents[];
|
|
28
43
|
/**
|
|
@@ -32,7 +47,10 @@ export default class WebContentsEventContainer {
|
|
|
32
47
|
*/
|
|
33
48
|
getOnce(event: string): WebContents[];
|
|
34
49
|
/**
|
|
35
|
-
* Получить всех отправителей для события.
|
|
50
|
+
* Получить всех уникальных отправителей для события.
|
|
51
|
+
*
|
|
52
|
+
* Один отправитель получает одно IPC-сообщение, даже если у него
|
|
53
|
+
* есть и многоразовый, и одноразовый обработчик.
|
|
36
54
|
* @param event - Имя события.
|
|
37
55
|
* @returns Отправители для события.
|
|
38
56
|
*/
|
|
@@ -43,9 +61,40 @@ export default class WebContentsEventContainer {
|
|
|
43
61
|
*/
|
|
44
62
|
clearOnce(event: string): void;
|
|
45
63
|
/**
|
|
46
|
-
*
|
|
47
|
-
* @param
|
|
48
|
-
* @
|
|
64
|
+
* Увеличить число подписок отправителя.
|
|
65
|
+
* @param event - Имя события.
|
|
66
|
+
* @param type - Тип подписки.
|
|
67
|
+
* @param sender - Отправитель.
|
|
68
|
+
*/
|
|
69
|
+
private increment;
|
|
70
|
+
/**
|
|
71
|
+
* Уменьшить число подписок отправителя.
|
|
72
|
+
* @param event - Имя события.
|
|
73
|
+
* @param type - Тип подписки.
|
|
74
|
+
* @param sender - Отправитель.
|
|
75
|
+
*/
|
|
76
|
+
private decrement;
|
|
77
|
+
/**
|
|
78
|
+
* Получить контейнер события или создать его.
|
|
79
|
+
* @param event - Имя события.
|
|
80
|
+
* @returns Контейнер события.
|
|
81
|
+
*/
|
|
82
|
+
private getOrCreate;
|
|
83
|
+
/**
|
|
84
|
+
* Удалить уничтоженные отправители.
|
|
85
|
+
* @param event - Имя события.
|
|
86
|
+
* @param container - Контейнер события.
|
|
87
|
+
*/
|
|
88
|
+
private prune;
|
|
89
|
+
/**
|
|
90
|
+
* Удалить контейнер события, если в нём не осталось подписчиков.
|
|
91
|
+
* @param event - Имя события.
|
|
92
|
+
* @param container - Контейнер события.
|
|
93
|
+
*/
|
|
94
|
+
private deleteIfEmpty;
|
|
95
|
+
/**
|
|
96
|
+
* Жив ли отправитель.
|
|
97
|
+
* @param sender - Отправитель.
|
|
49
98
|
*/
|
|
50
|
-
private
|
|
99
|
+
private static isAlive;
|
|
51
100
|
}
|
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Обёртка над стандартным `WebContents`, позволяющая использовать события.
|
|
3
|
+
*
|
|
4
|
+
* Хранит только живые `WebContents` и удаляет опустевшие события,
|
|
5
|
+
* чтобы долгоживущий main процесс не накапливал мусор.
|
|
3
6
|
*/
|
|
4
7
|
export default class WebContentsEventContainer {
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
this.containers = {};
|
|
10
|
-
}
|
|
8
|
+
/**
|
|
9
|
+
* Контейнеры событий.
|
|
10
|
+
*/
|
|
11
|
+
containers = new Map();
|
|
11
12
|
/**
|
|
12
13
|
* Добавить многоразового отправителя для события.
|
|
13
14
|
* @param event - Имя события.
|
|
14
15
|
* @param sender - Отправитель.
|
|
15
16
|
*/
|
|
16
17
|
addOn(event, sender) {
|
|
17
|
-
this.
|
|
18
|
+
this.increment(event, 'on', sender);
|
|
18
19
|
}
|
|
19
20
|
/**
|
|
20
21
|
* Добавить одноразового отправителя для события.
|
|
@@ -22,15 +23,36 @@ export default class WebContentsEventContainer {
|
|
|
22
23
|
* @param sender - Отправитель.
|
|
23
24
|
*/
|
|
24
25
|
addOnce(event, sender) {
|
|
25
|
-
this.
|
|
26
|
+
this.increment(event, 'once', sender);
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Удалить одну подписку многоразового отправителя.
|
|
30
|
+
* @param event - Имя события.
|
|
31
|
+
* @param sender - Отправитель.
|
|
32
|
+
*/
|
|
33
|
+
removeOn(event, sender) {
|
|
34
|
+
this.decrement(event, 'on', sender);
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Удалить одну подписку одноразового отправителя.
|
|
38
|
+
* @param event - Имя события.
|
|
39
|
+
* @param sender - Отправитель.
|
|
40
|
+
*/
|
|
41
|
+
removeOnce(event, sender) {
|
|
42
|
+
this.decrement(event, 'once', sender);
|
|
26
43
|
}
|
|
27
44
|
/**
|
|
28
45
|
* Получить многоразовых отправителей для события.
|
|
29
46
|
* @param event - Имя события.
|
|
30
|
-
* @returns
|
|
47
|
+
* @returns Многоразовые отправители для события.
|
|
31
48
|
*/
|
|
32
49
|
getOn(event) {
|
|
33
|
-
|
|
50
|
+
const container = this.containers.get(event);
|
|
51
|
+
if (!container) {
|
|
52
|
+
return [];
|
|
53
|
+
}
|
|
54
|
+
this.prune(event, container);
|
|
55
|
+
return [...container.on.keys()];
|
|
34
56
|
}
|
|
35
57
|
/**
|
|
36
58
|
* Получить одноразовых отправителей для события.
|
|
@@ -38,35 +60,138 @@ export default class WebContentsEventContainer {
|
|
|
38
60
|
* @returns Одноразовые отправители для события.
|
|
39
61
|
*/
|
|
40
62
|
getOnce(event) {
|
|
41
|
-
|
|
63
|
+
const container = this.containers.get(event);
|
|
64
|
+
if (!container) {
|
|
65
|
+
return [];
|
|
66
|
+
}
|
|
67
|
+
this.prune(event, container);
|
|
68
|
+
return [...container.once.keys()];
|
|
42
69
|
}
|
|
43
70
|
/**
|
|
44
|
-
* Получить всех отправителей для события.
|
|
71
|
+
* Получить всех уникальных отправителей для события.
|
|
72
|
+
*
|
|
73
|
+
* Один отправитель получает одно IPC-сообщение, даже если у него
|
|
74
|
+
* есть и многоразовый, и одноразовый обработчик.
|
|
45
75
|
* @param event - Имя события.
|
|
46
76
|
* @returns Отправители для события.
|
|
47
77
|
*/
|
|
48
78
|
getAll(event) {
|
|
49
|
-
const container = this.
|
|
50
|
-
|
|
79
|
+
const container = this.containers.get(event);
|
|
80
|
+
if (!container) {
|
|
81
|
+
return [];
|
|
82
|
+
}
|
|
83
|
+
this.prune(event, container);
|
|
84
|
+
const senders = [...container.on.keys()];
|
|
85
|
+
for (const sender of container.once.keys()) {
|
|
86
|
+
if (!container.on.has(sender)) {
|
|
87
|
+
senders.push(sender);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return senders;
|
|
51
91
|
}
|
|
52
92
|
/**
|
|
53
93
|
* Удалить одноразовых отправителей для события.
|
|
54
94
|
* @param event - Имя события.
|
|
55
95
|
*/
|
|
56
96
|
clearOnce(event) {
|
|
57
|
-
this.
|
|
97
|
+
const container = this.containers.get(event);
|
|
98
|
+
if (!container) {
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
container.once.clear();
|
|
102
|
+
this.prune(event, container);
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Увеличить число подписок отправителя.
|
|
106
|
+
* @param event - Имя события.
|
|
107
|
+
* @param type - Тип подписки.
|
|
108
|
+
* @param sender - Отправитель.
|
|
109
|
+
*/
|
|
110
|
+
increment(event, type, sender) {
|
|
111
|
+
const container = this.getOrCreate(event);
|
|
112
|
+
if (!WebContentsEventContainer.isAlive(sender)) {
|
|
113
|
+
this.deleteIfEmpty(event, container);
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
container[type].set(sender, (container[type].get(sender) ?? 0) + 1);
|
|
58
117
|
}
|
|
59
118
|
/**
|
|
60
|
-
*
|
|
61
|
-
* @param
|
|
62
|
-
* @
|
|
119
|
+
* Уменьшить число подписок отправителя.
|
|
120
|
+
* @param event - Имя события.
|
|
121
|
+
* @param type - Тип подписки.
|
|
122
|
+
* @param sender - Отправитель.
|
|
123
|
+
*/
|
|
124
|
+
decrement(event, type, sender) {
|
|
125
|
+
const container = this.containers.get(event);
|
|
126
|
+
if (!container) {
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
const count = container[type].get(sender);
|
|
130
|
+
if (count === undefined) {
|
|
131
|
+
return;
|
|
132
|
+
}
|
|
133
|
+
if (count <= 1) {
|
|
134
|
+
container[type].delete(sender);
|
|
135
|
+
}
|
|
136
|
+
else {
|
|
137
|
+
container[type].set(sender, count - 1);
|
|
138
|
+
}
|
|
139
|
+
this.deleteIfEmpty(event, container);
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Получить контейнер события или создать его.
|
|
143
|
+
* @param event - Имя события.
|
|
144
|
+
* @returns Контейнер события.
|
|
145
|
+
*/
|
|
146
|
+
getOrCreate(event) {
|
|
147
|
+
let container = this.containers.get(event);
|
|
148
|
+
if (!container) {
|
|
149
|
+
container = { on: new Map(), once: new Map() };
|
|
150
|
+
this.containers.set(event, container);
|
|
151
|
+
}
|
|
152
|
+
else {
|
|
153
|
+
this.prune(event, container);
|
|
154
|
+
if (!this.containers.has(event)) {
|
|
155
|
+
container = { on: new Map(), once: new Map() };
|
|
156
|
+
this.containers.set(event, container);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
return container;
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Удалить уничтоженные отправители.
|
|
163
|
+
* @param event - Имя события.
|
|
164
|
+
* @param container - Контейнер события.
|
|
165
|
+
*/
|
|
166
|
+
prune(event, container) {
|
|
167
|
+
for (const sender of container.on.keys()) {
|
|
168
|
+
if (!WebContentsEventContainer.isAlive(sender)) {
|
|
169
|
+
container.on.delete(sender);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
for (const sender of container.once.keys()) {
|
|
173
|
+
if (!WebContentsEventContainer.isAlive(sender)) {
|
|
174
|
+
container.once.delete(sender);
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
this.deleteIfEmpty(event, container);
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
* Удалить контейнер события, если в нём не осталось подписчиков.
|
|
181
|
+
* @param event - Имя события.
|
|
182
|
+
* @param container - Контейнер события.
|
|
183
|
+
*/
|
|
184
|
+
deleteIfEmpty(event, container) {
|
|
185
|
+
if (container.on.size === 0 && container.once.size === 0) {
|
|
186
|
+
this.containers.delete(event);
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* Жив ли отправитель.
|
|
191
|
+
* @param sender - Отправитель.
|
|
63
192
|
*/
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
return this.containers[name] = {
|
|
68
|
-
on: container.on.filter(item => !item.isDestroyed()),
|
|
69
|
-
once: container.once.filter(item => !item.isDestroyed()),
|
|
70
|
-
};
|
|
193
|
+
static isAlive(sender) {
|
|
194
|
+
const candidate = sender;
|
|
195
|
+
return typeof candidate.isDestroyed !== 'function' || !candidate.isDestroyed();
|
|
71
196
|
}
|
|
72
197
|
}
|