emr-bridge 2.0.1 → 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
|
@@ -12,11 +12,11 @@ export default abstract class BaseBridge implements IBridge {
|
|
|
12
12
|
*/
|
|
13
13
|
protected readonly target: {
|
|
14
14
|
as: () => any;
|
|
15
|
-
emit: (
|
|
16
|
-
on: (
|
|
17
|
-
once: (
|
|
18
|
-
call: (
|
|
19
|
-
returns: (
|
|
15
|
+
emit: (...args: Parameters<typeof this.emit>) => void;
|
|
16
|
+
on: (...args: Parameters<typeof this.on<any>>) => EventUnsubscribe;
|
|
17
|
+
once: (...args: Parameters<typeof this.once<any>>) => EventUnsubscribe;
|
|
18
|
+
call: (...args: Parameters<typeof this.call<any, any>>) => any;
|
|
19
|
+
returns: (...args: Parameters<typeof this.returns<any, any>>) => any;
|
|
20
20
|
};
|
|
21
21
|
as<TTarget>(): IBridge & TTarget;
|
|
22
22
|
emit(name: string, value: any): void;
|
|
@@ -24,7 +24,7 @@ export default abstract class BaseBridge implements IBridge {
|
|
|
24
24
|
once<TValue = any>(name: string, listener: EventListener<TValue>): EventUnsubscribe;
|
|
25
25
|
call<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
|
|
26
26
|
new (): IHasSnapshot;
|
|
27
|
-
}>(func: TFunc, Class: TClass, args
|
|
27
|
+
}>(func: TFunc, Class: TClass, args?: Parameters<TFunc>): InstanceType<TClass>;
|
|
28
28
|
returns<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
|
|
29
29
|
new (): IHasSnapshot;
|
|
30
30
|
}>(func: TFunc, Class: TClass): TFunc;
|
|
@@ -80,16 +80,23 @@ export default abstract class BaseBridge implements IBridge {
|
|
|
80
80
|
protected handlePossibleError(channel: string, error?: string): void | never;
|
|
81
81
|
/**
|
|
82
82
|
* Инициализировать доступ к публичным функциям.
|
|
83
|
+
* @param functions - Имена функций.
|
|
83
84
|
*/
|
|
84
|
-
protected initFunctions(): void;
|
|
85
|
+
protected initFunctions(functions?: Iterable<string>): void;
|
|
85
86
|
/**
|
|
86
87
|
* Инициализировать доступ к публичным переменным.
|
|
88
|
+
* @param variables - Имена переменных.
|
|
87
89
|
*/
|
|
88
|
-
protected initVariables(): void;
|
|
90
|
+
protected initVariables(variables?: Iterable<string>): void;
|
|
89
91
|
/**
|
|
90
92
|
* Добавить сущность в `target`.
|
|
91
93
|
* @param name - Имя.
|
|
92
94
|
* @param descriptor - Дескриптор значения.
|
|
93
95
|
*/
|
|
94
96
|
protected define<TValue = unknown>(name: string, descriptor?: TypedPropertyDescriptor<TValue>): void;
|
|
97
|
+
/**
|
|
98
|
+
* Проверить, что обработчик события является функцией.
|
|
99
|
+
* @param listener - Обработчик.
|
|
100
|
+
*/
|
|
101
|
+
private assertListener;
|
|
95
102
|
}
|
|
@@ -1,45 +1,59 @@
|
|
|
1
|
-
import { NoGetAccessError, TrySetReadonlyError } from '../errors.js';
|
|
2
|
-
import { Errors, Id, Transfer } from './helpers/index.js';
|
|
1
|
+
import { NoGetAccessError, NoResponseFromMainError, TrySetReadonlyError } from '../errors.js';
|
|
2
|
+
import { Errors, Id, Names, Transfer } from './helpers/index.js';
|
|
3
3
|
/**
|
|
4
4
|
* Базовый класс моста до main.
|
|
5
5
|
*/
|
|
6
6
|
export default class BaseBridge {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
this.
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
};
|
|
19
|
-
}
|
|
7
|
+
/**
|
|
8
|
+
* Объект, который будет использоваться пользователем.
|
|
9
|
+
*/
|
|
10
|
+
target = {
|
|
11
|
+
as: () => this.as(),
|
|
12
|
+
emit: (...args) => this.emit(...args),
|
|
13
|
+
on: (...args) => this.on(...args),
|
|
14
|
+
once: (...args) => this.once(...args),
|
|
15
|
+
call: (...args) => this.call(...args),
|
|
16
|
+
returns: (...args) => this.returns(...args)
|
|
17
|
+
};
|
|
20
18
|
as() {
|
|
21
19
|
return this.target;
|
|
22
20
|
}
|
|
23
21
|
emit(name, value) {
|
|
22
|
+
Names.validateEvent(name);
|
|
24
23
|
this.emitEvent(name, Transfer.toTransferable(value));
|
|
25
24
|
}
|
|
26
25
|
on(name, listener) {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
Names.validateEvent(name);
|
|
27
|
+
this.assertListener(listener);
|
|
28
|
+
return this.handleEvent(name, 'on', (result) => {
|
|
29
|
+
if (!result) {
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
this.handlePossibleError(`event: ${name}`, result.error);
|
|
33
|
+
listener(result.value);
|
|
30
34
|
});
|
|
31
35
|
}
|
|
32
36
|
once(name, listener) {
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
37
|
+
Names.validateEvent(name);
|
|
38
|
+
this.assertListener(listener);
|
|
39
|
+
return this.handleEvent(name, 'once', (result) => {
|
|
40
|
+
if (!result) {
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
this.handlePossibleError(`event: ${name}`, result.error);
|
|
44
|
+
listener(result.value);
|
|
36
45
|
});
|
|
37
46
|
}
|
|
38
|
-
call(func, Class, args) {
|
|
47
|
+
call(func, Class, args = []) {
|
|
39
48
|
const value = func(...args);
|
|
40
49
|
if (Transfer.isSnapshotValue(value)) {
|
|
41
50
|
return Transfer.getFromSnapshot(value, Class);
|
|
42
51
|
}
|
|
52
|
+
if (Transfer.isPromiseLike(value)) {
|
|
53
|
+
return value.then(result => (Transfer.isSnapshotValue(result)
|
|
54
|
+
? Transfer.getFromSnapshot(result, Class)
|
|
55
|
+
: result));
|
|
56
|
+
}
|
|
43
57
|
return value;
|
|
44
58
|
}
|
|
45
59
|
returns(func, Class) {
|
|
@@ -49,8 +63,12 @@ export default class BaseBridge {
|
|
|
49
63
|
* Инициализация моста.
|
|
50
64
|
*/
|
|
51
65
|
init() {
|
|
52
|
-
this.
|
|
53
|
-
|
|
66
|
+
const info = this.entitiesInfo;
|
|
67
|
+
if (!info) {
|
|
68
|
+
throw new NoResponseFromMainError('entitiesInfo');
|
|
69
|
+
}
|
|
70
|
+
this.initFunctions(info.functions);
|
|
71
|
+
this.initVariables(info.variables);
|
|
54
72
|
}
|
|
55
73
|
/**
|
|
56
74
|
* Обработать возможную ошибку.
|
|
@@ -63,40 +81,54 @@ export default class BaseBridge {
|
|
|
63
81
|
if (!error) {
|
|
64
82
|
return;
|
|
65
83
|
}
|
|
66
|
-
|
|
84
|
+
const message = error.startsWith('Error: ') ? error.slice(7) : error;
|
|
85
|
+
throw new Error(`Error on ${channel}.\n${message}`);
|
|
67
86
|
}
|
|
68
87
|
/**
|
|
69
88
|
* Инициализировать доступ к публичным функциям.
|
|
89
|
+
* @param functions - Имена функций.
|
|
70
90
|
*/
|
|
71
|
-
initFunctions() {
|
|
72
|
-
for (const name of
|
|
91
|
+
initFunctions(functions) {
|
|
92
|
+
for (const name of functions ?? []) {
|
|
93
|
+
Names.validateEntity(name);
|
|
73
94
|
this.define(name, {
|
|
74
95
|
value: (...args) => {
|
|
75
96
|
const id = Id.new();
|
|
76
97
|
const preparedArgs = args.map(arg => Transfer.toTransferable(arg));
|
|
77
|
-
const
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
98
|
+
const result = this.callFunction(name, id, preparedArgs);
|
|
99
|
+
if (!result) {
|
|
100
|
+
throw new NoResponseFromMainError(name);
|
|
101
|
+
}
|
|
102
|
+
this.handlePossibleError(name, result.error);
|
|
103
|
+
return result.promiseChannel
|
|
104
|
+
? this.waitPromise(result.promiseChannel, id)
|
|
105
|
+
: result.value;
|
|
82
106
|
}
|
|
83
107
|
});
|
|
84
108
|
}
|
|
85
109
|
}
|
|
86
110
|
/**
|
|
87
111
|
* Инициализировать доступ к публичным переменным.
|
|
112
|
+
* @param variables - Имена переменных.
|
|
88
113
|
*/
|
|
89
|
-
initVariables() {
|
|
90
|
-
for (const name of
|
|
114
|
+
initVariables(variables) {
|
|
115
|
+
for (const name of variables ?? []) {
|
|
116
|
+
Names.validateEntity(name);
|
|
91
117
|
this.define(name, {
|
|
92
118
|
get: () => {
|
|
93
|
-
const
|
|
94
|
-
|
|
95
|
-
|
|
119
|
+
const result = this.getVariable(name);
|
|
120
|
+
if (!result) {
|
|
121
|
+
throw new NoResponseFromMainError(name);
|
|
122
|
+
}
|
|
123
|
+
this.handlePossibleError(name, result.error);
|
|
124
|
+
return result.value;
|
|
96
125
|
},
|
|
97
126
|
set: (value) => {
|
|
98
|
-
const
|
|
99
|
-
|
|
127
|
+
const result = this.setVariable(name, value);
|
|
128
|
+
if (!result) {
|
|
129
|
+
throw new NoResponseFromMainError(name);
|
|
130
|
+
}
|
|
131
|
+
this.handlePossibleError(name, result.error);
|
|
100
132
|
}
|
|
101
133
|
});
|
|
102
134
|
}
|
|
@@ -107,19 +139,33 @@ export default class BaseBridge {
|
|
|
107
139
|
* @param descriptor - Дескриптор значения.
|
|
108
140
|
*/
|
|
109
141
|
define(name, descriptor) {
|
|
110
|
-
|
|
142
|
+
if (!descriptor) {
|
|
143
|
+
throw new TypeError(`Не задан дескриптор сущности '${name}'.`);
|
|
144
|
+
}
|
|
145
|
+
const hasValue = 'value' in descriptor;
|
|
111
146
|
const defaultDescriptor = {
|
|
112
147
|
get: () => descriptor.value,
|
|
113
148
|
set: Errors.getThrower(TrySetReadonlyError, name),
|
|
114
|
-
enumerable: true
|
|
149
|
+
enumerable: true,
|
|
150
|
+
configurable: true
|
|
115
151
|
};
|
|
116
152
|
const noValueDescriptor = {
|
|
117
|
-
get: descriptor
|
|
118
|
-
set: descriptor
|
|
119
|
-
enumerable: true
|
|
153
|
+
get: descriptor.get || Errors.getThrower(NoGetAccessError, name),
|
|
154
|
+
set: descriptor.set || Errors.getThrower(TrySetReadonlyError, name),
|
|
155
|
+
enumerable: true,
|
|
156
|
+
configurable: true
|
|
120
157
|
};
|
|
121
158
|
Object.defineProperty(this.target, name, hasValue
|
|
122
159
|
? defaultDescriptor
|
|
123
160
|
: noValueDescriptor);
|
|
124
161
|
}
|
|
162
|
+
/**
|
|
163
|
+
* Проверить, что обработчик события является функцией.
|
|
164
|
+
* @param listener - Обработчик.
|
|
165
|
+
*/
|
|
166
|
+
assertListener(listener) {
|
|
167
|
+
if (typeof listener !== 'function') {
|
|
168
|
+
throw new TypeError('Обработчик события должен быть функцией.');
|
|
169
|
+
}
|
|
170
|
+
}
|
|
125
171
|
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { IEntitiesInfo } from '../../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Хелпер для безопасного чтения информации о публичных сущностях из IPC.
|
|
4
|
+
*/
|
|
5
|
+
export default class EntitiesInfo {
|
|
6
|
+
/**
|
|
7
|
+
* Прочитать информацию о сущностях.
|
|
8
|
+
*
|
|
9
|
+
* Значение из IPC недоверенное: неверный формат или мусорные имена
|
|
10
|
+
* должны отбрасываться, а не ломать мост.
|
|
11
|
+
* @param value - Данные из IPC.
|
|
12
|
+
* @returns Информация о сущностях или `null`.
|
|
13
|
+
*/
|
|
14
|
+
static read(value: unknown): IEntitiesInfo | null;
|
|
15
|
+
/**
|
|
16
|
+
* Является ли значение итерируемым.
|
|
17
|
+
* @param value - Значение.
|
|
18
|
+
*/
|
|
19
|
+
private static isIterable;
|
|
20
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для безопасного чтения информации о публичных сущностях из IPC.
|
|
3
|
+
*/
|
|
4
|
+
export default class EntitiesInfo {
|
|
5
|
+
/**
|
|
6
|
+
* Прочитать информацию о сущностях.
|
|
7
|
+
*
|
|
8
|
+
* Значение из IPC недоверенное: неверный формат или мусорные имена
|
|
9
|
+
* должны отбрасываться, а не ломать мост.
|
|
10
|
+
* @param value - Данные из IPC.
|
|
11
|
+
* @returns Информация о сущностях или `null`.
|
|
12
|
+
*/
|
|
13
|
+
static read(value) {
|
|
14
|
+
if (!value || typeof value !== 'object') {
|
|
15
|
+
return null;
|
|
16
|
+
}
|
|
17
|
+
const candidate = value;
|
|
18
|
+
if (!EntitiesInfo.isIterable(candidate.functions) || !EntitiesInfo.isIterable(candidate.variables)) {
|
|
19
|
+
return null;
|
|
20
|
+
}
|
|
21
|
+
return {
|
|
22
|
+
functions: new Set(Array.from(candidate.functions).filter((name) => typeof name === 'string')),
|
|
23
|
+
variables: new Set(Array.from(candidate.variables).filter((name) => typeof name === 'string'))
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Является ли значение итерируемым.
|
|
28
|
+
* @param value - Значение.
|
|
29
|
+
*/
|
|
30
|
+
static isIterable(value) {
|
|
31
|
+
return (value !== null
|
|
32
|
+
&& value !== undefined
|
|
33
|
+
&& typeof value[Symbol.iterator] === 'function');
|
|
34
|
+
}
|
|
35
|
+
}
|
|
@@ -12,7 +12,7 @@ export default class Env {
|
|
|
12
12
|
* Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
|
|
13
13
|
*/
|
|
14
14
|
static get hasProvider() {
|
|
15
|
-
return Boolean(window.__provider__);
|
|
15
|
+
return Env.hasWindow && Boolean(window.__provider__);
|
|
16
16
|
}
|
|
17
17
|
/**
|
|
18
18
|
* Является ли окружение `preload` процессом.
|
|
@@ -2,8 +2,17 @@
|
|
|
2
2
|
* Хелпер для работы с идентификаторами.
|
|
3
3
|
*/
|
|
4
4
|
export default class Id {
|
|
5
|
+
/**
|
|
6
|
+
* Счётчик для генерации идентификаторов без криптографического API.
|
|
7
|
+
*/
|
|
8
|
+
private static counter;
|
|
5
9
|
/**
|
|
6
10
|
* Создать новый идентификатор.
|
|
11
|
+
*
|
|
12
|
+
* `Math.random` в одиночку не гарантирует уникальность: коллизия
|
|
13
|
+
* идентификаторов может разрешить чужое обещание. Поэтому при наличии
|
|
14
|
+
* используется `crypto.randomUUID`, а запасной вариант содержит
|
|
15
|
+
* монотонный счётчик процесса.
|
|
7
16
|
*/
|
|
8
17
|
static new(): string;
|
|
9
18
|
}
|
|
@@ -2,10 +2,24 @@
|
|
|
2
2
|
* Хелпер для работы с идентификаторами.
|
|
3
3
|
*/
|
|
4
4
|
export default class Id {
|
|
5
|
+
/**
|
|
6
|
+
* Счётчик для генерации идентификаторов без криптографического API.
|
|
7
|
+
*/
|
|
8
|
+
static counter = 0;
|
|
5
9
|
/**
|
|
6
10
|
* Создать новый идентификатор.
|
|
11
|
+
*
|
|
12
|
+
* `Math.random` в одиночку не гарантирует уникальность: коллизия
|
|
13
|
+
* идентификаторов может разрешить чужое обещание. Поэтому при наличии
|
|
14
|
+
* используется `crypto.randomUUID`, а запасной вариант содержит
|
|
15
|
+
* монотонный счётчик процесса.
|
|
7
16
|
*/
|
|
8
17
|
static new() {
|
|
9
|
-
|
|
18
|
+
const crypto = globalThis.crypto;
|
|
19
|
+
if (crypto && typeof crypto.randomUUID === 'function') {
|
|
20
|
+
return crypto.randomUUID();
|
|
21
|
+
}
|
|
22
|
+
Id.counter = (Id.counter + 1) % Number.MAX_SAFE_INTEGER;
|
|
23
|
+
return `${Date.now().toString(36)}-${Id.counter.toString(36)}-${Math.random().toString(36).slice(2)}`;
|
|
10
24
|
}
|
|
11
25
|
}
|
|
@@ -1,8 +1,11 @@
|
|
|
1
|
+
export { default as EntitiesInfo } from './entities-info.js';
|
|
1
2
|
export { default as Env } from './env.js';
|
|
2
3
|
export { default as Errors } from './errors.js';
|
|
3
4
|
export { default as Id } from './id.js';
|
|
4
5
|
export { default as IpcChannel } from './ipc-channel.js';
|
|
5
6
|
export { default as IpcEventInMain } from './ipc-event-in-main.js';
|
|
7
|
+
export { default as IpcPayload } from './ipc-payload.js';
|
|
6
8
|
export { default as IpcResult } from './ipc-result.js';
|
|
9
|
+
export { default as Names } from './names.js';
|
|
7
10
|
export { default as Transfer } from './transfer.js';
|
|
8
11
|
export { default as WebContentsEventsContainer } from './web-contents-events-container.js';
|
|
@@ -1,8 +1,11 @@
|
|
|
1
|
+
export { default as EntitiesInfo } from './entities-info.js';
|
|
1
2
|
export { default as Env } from './env.js';
|
|
2
3
|
export { default as Errors } from './errors.js';
|
|
3
4
|
export { default as Id } from './id.js';
|
|
4
5
|
export { default as IpcChannel } from './ipc-channel.js';
|
|
5
6
|
export { default as IpcEventInMain } from './ipc-event-in-main.js';
|
|
7
|
+
export { default as IpcPayload } from './ipc-payload.js';
|
|
6
8
|
export { default as IpcResult } from './ipc-result.js';
|
|
9
|
+
export { default as Names } from './names.js';
|
|
7
10
|
export { default as Transfer } from './transfer.js';
|
|
8
11
|
export { default as WebContentsEventsContainer } from './web-contents-events-container.js';
|
|
@@ -43,6 +43,11 @@ export default class IpcChannel {
|
|
|
43
43
|
* @returns Канал вызова события.
|
|
44
44
|
*/
|
|
45
45
|
emit: (name: string) => string;
|
|
46
|
+
/**
|
|
47
|
+
* Получить канал отписки от события.
|
|
48
|
+
* @returns Канал отписки от события.
|
|
49
|
+
*/
|
|
50
|
+
off: () => string;
|
|
46
51
|
};
|
|
47
52
|
/**
|
|
48
53
|
* Публичное свойство.
|
|
@@ -71,5 +76,10 @@ export default class IpcChannel {
|
|
|
71
76
|
* @returns Канал обработки обещания.
|
|
72
77
|
*/
|
|
73
78
|
get: (channel: string) => string;
|
|
79
|
+
/**
|
|
80
|
+
* Является ли канал каналом обработки обещания моста.
|
|
81
|
+
* @param channel - Проверяемый канал.
|
|
82
|
+
*/
|
|
83
|
+
is: (channel: unknown) => channel is string;
|
|
74
84
|
};
|
|
75
85
|
}
|
|
@@ -1,76 +1,87 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Хелпер для работы с каналом IPC.
|
|
3
3
|
*/
|
|
4
|
-
class IpcChannel {
|
|
5
|
-
}
|
|
6
|
-
/**
|
|
7
|
-
* Информация о публичных сущностях.
|
|
8
|
-
*/
|
|
9
|
-
IpcChannel.publicInfo = {
|
|
10
|
-
/**
|
|
11
|
-
* Получить канал получения информации.
|
|
12
|
-
* @returns Канал получения информации
|
|
13
|
-
*/
|
|
14
|
-
get: () => 'GET_PUBLIC_INFO'
|
|
15
|
-
};
|
|
16
|
-
/**
|
|
17
|
-
* Публичная функция.
|
|
18
|
-
*/
|
|
19
|
-
IpcChannel.func = {
|
|
20
|
-
/**
|
|
21
|
-
* Получить канал вызова функции.
|
|
22
|
-
* @param name - Имя функции.
|
|
23
|
-
* @returns Канал вызова функции.
|
|
24
|
-
*/
|
|
25
|
-
call: (name) => `FUNCTION_CALL_${name}`
|
|
26
|
-
};
|
|
27
|
-
/**
|
|
28
|
-
* Публичное событие.
|
|
29
|
-
*/
|
|
30
|
-
IpcChannel.event = {
|
|
4
|
+
export default class IpcChannel {
|
|
31
5
|
/**
|
|
32
|
-
*
|
|
33
|
-
* @returns Канал отслеживания события.
|
|
6
|
+
* Информация о публичных сущностях.
|
|
34
7
|
*/
|
|
35
|
-
|
|
8
|
+
static publicInfo = {
|
|
9
|
+
/**
|
|
10
|
+
* Получить канал получения информации.
|
|
11
|
+
* @returns Канал получения информации
|
|
12
|
+
*/
|
|
13
|
+
get: () => 'GET_PUBLIC_INFO'
|
|
14
|
+
};
|
|
36
15
|
/**
|
|
37
|
-
*
|
|
38
|
-
* @returns Канал однократного отслеживания события.
|
|
16
|
+
* Публичная функция.
|
|
39
17
|
*/
|
|
40
|
-
|
|
18
|
+
static func = {
|
|
19
|
+
/**
|
|
20
|
+
* Получить канал вызова функции.
|
|
21
|
+
* @param name - Имя функции.
|
|
22
|
+
* @returns Канал вызова функции.
|
|
23
|
+
*/
|
|
24
|
+
call: (name) => `FUNCTION_CALL_${name}`
|
|
25
|
+
};
|
|
41
26
|
/**
|
|
42
|
-
*
|
|
43
|
-
* @param name - Название события.
|
|
44
|
-
* @returns Канал вызова события.
|
|
27
|
+
* Публичное событие.
|
|
45
28
|
*/
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
29
|
+
static event = {
|
|
30
|
+
/**
|
|
31
|
+
* Получить канал отслеживания события.
|
|
32
|
+
* @returns Канал отслеживания события.
|
|
33
|
+
*/
|
|
34
|
+
on: () => 'EVENT_ON',
|
|
35
|
+
/**
|
|
36
|
+
* Получить канал однократного отслеживания события.
|
|
37
|
+
* @returns Канал однократного отслеживания события.
|
|
38
|
+
*/
|
|
39
|
+
once: () => 'EVENT_ONCE',
|
|
40
|
+
/**
|
|
41
|
+
* Получить канал вызова события.
|
|
42
|
+
* @param name - Название события.
|
|
43
|
+
* @returns Канал вызова события.
|
|
44
|
+
*/
|
|
45
|
+
emit: (name) => `EVENT_EMIT_${name}`,
|
|
46
|
+
/**
|
|
47
|
+
* Получить канал отписки от события.
|
|
48
|
+
* @returns Канал отписки от события.
|
|
49
|
+
*/
|
|
50
|
+
off: () => 'EVENT_OFF'
|
|
51
|
+
};
|
|
52
52
|
/**
|
|
53
|
-
*
|
|
54
|
-
* @param name - Имя свойства.
|
|
55
|
-
* @returns Канал получения значения свойства.
|
|
53
|
+
* Публичное свойство.
|
|
56
54
|
*/
|
|
57
|
-
|
|
55
|
+
static prop = {
|
|
56
|
+
/**
|
|
57
|
+
* Получить канал получения значения свойства.
|
|
58
|
+
* @param name - Имя свойства.
|
|
59
|
+
* @returns Канал получения значения свойства.
|
|
60
|
+
*/
|
|
61
|
+
get: (name) => `PROPERTY_GET_${name}`,
|
|
62
|
+
/**
|
|
63
|
+
* Получить канал установки значения свойства.
|
|
64
|
+
* @param name - Имя свойства.
|
|
65
|
+
* @returns Канал получения установки значения свойства.
|
|
66
|
+
*/
|
|
67
|
+
set: (name) => `PROPERTY_SET_${name}`
|
|
68
|
+
};
|
|
58
69
|
/**
|
|
59
|
-
*
|
|
60
|
-
* @param name - Имя свойства.
|
|
61
|
-
* @returns Канал получения установки значения свойства.
|
|
70
|
+
* Обещание.
|
|
62
71
|
*/
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
72
|
+
static promise = {
|
|
73
|
+
/**
|
|
74
|
+
* Получить канал обработки обещания.
|
|
75
|
+
* @param channel - Канал, который возвращает обещание.
|
|
76
|
+
* @returns Канал обработки обещания.
|
|
77
|
+
*/
|
|
78
|
+
get: (channel) => `${channel}_PROMISE`,
|
|
79
|
+
/**
|
|
80
|
+
* Является ли канал каналом обработки обещания моста.
|
|
81
|
+
* @param channel - Проверяемый канал.
|
|
82
|
+
*/
|
|
83
|
+
is: (channel) => (typeof channel === 'string'
|
|
84
|
+
&& channel.startsWith(IpcChannel.func.call(''))
|
|
85
|
+
&& channel.endsWith('_PROMISE'))
|
|
86
|
+
};
|
|
87
|
+
}
|
|
@@ -4,7 +4,10 @@ import type { IResult } from '../../types.js';
|
|
|
4
4
|
* Событие вызова IPC в `main` процессе.
|
|
5
5
|
*/
|
|
6
6
|
export default class IpcEventInMain {
|
|
7
|
-
|
|
7
|
+
/**
|
|
8
|
+
* Оригинальное IPC событие.
|
|
9
|
+
*/
|
|
10
|
+
private readonly event;
|
|
8
11
|
/**
|
|
9
12
|
* Создать событие вызова IPC в `main` процессе.
|
|
10
13
|
* @param event - Оригинальное IPC событие.
|
|
@@ -12,6 +15,9 @@ export default class IpcEventInMain {
|
|
|
12
15
|
constructor(event: IpcMainEvent);
|
|
13
16
|
/**
|
|
14
17
|
* Отправить сообщение в канал `renderer` процесса.
|
|
18
|
+
*
|
|
19
|
+
* Уничтоженный получатель или ошибка сериализации не должны
|
|
20
|
+
* ронять main процесс.
|
|
15
21
|
* @param channel - IPC канал.
|
|
16
22
|
* @param result - Отправляемый результат.
|
|
17
23
|
*/
|
|
@@ -1,7 +1,12 @@
|
|
|
1
|
+
import IpcResult from './ipc-result.js';
|
|
1
2
|
/**
|
|
2
3
|
* Событие вызова IPC в `main` процессе.
|
|
3
4
|
*/
|
|
4
5
|
export default class IpcEventInMain {
|
|
6
|
+
/**
|
|
7
|
+
* Оригинальное IPC событие.
|
|
8
|
+
*/
|
|
9
|
+
event;
|
|
5
10
|
/**
|
|
6
11
|
* Создать событие вызова IPC в `main` процессе.
|
|
7
12
|
* @param event - Оригинальное IPC событие.
|
|
@@ -11,17 +16,34 @@ export default class IpcEventInMain {
|
|
|
11
16
|
}
|
|
12
17
|
/**
|
|
13
18
|
* Отправить сообщение в канал `renderer` процесса.
|
|
19
|
+
*
|
|
20
|
+
* Уничтоженный получатель или ошибка сериализации не должны
|
|
21
|
+
* ронять main процесс.
|
|
14
22
|
* @param channel - IPC канал.
|
|
15
23
|
* @param result - Отправляемый результат.
|
|
16
24
|
*/
|
|
17
25
|
send(channel, result) {
|
|
18
|
-
this.event.sender
|
|
26
|
+
const sender = this.event.sender;
|
|
27
|
+
if (!sender || sender.isDestroyed()) {
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
try {
|
|
31
|
+
sender.send(channel, result);
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
// Получатель мог быть уничтожен между проверкой и отправкой.
|
|
35
|
+
}
|
|
19
36
|
}
|
|
20
37
|
/**
|
|
21
38
|
* Вернуть результат вызова IPC.
|
|
22
39
|
* @param value - Результат.
|
|
23
40
|
*/
|
|
24
41
|
return(value) {
|
|
25
|
-
|
|
42
|
+
try {
|
|
43
|
+
this.event.returnValue = value;
|
|
44
|
+
}
|
|
45
|
+
catch (error) {
|
|
46
|
+
this.event.returnValue = IpcResult.createWithError(error);
|
|
47
|
+
}
|
|
26
48
|
}
|
|
27
49
|
}
|