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
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import type { EventListener, EventUnsubscribe, IBridge, IResult } from '../../types.js';
|
|
1
|
+
import type { EventListener, EventUnsubscribe, IBridge, IEntitiesInfo, IResult } from '../../types.js';
|
|
2
2
|
import BaseBridge from '../base-bridge.js';
|
|
3
3
|
/**
|
|
4
4
|
* Мост preload-main.
|
|
5
5
|
*/
|
|
6
6
|
export declare class PreloadBridge extends BaseBridge {
|
|
7
|
-
protected readonly entitiesInfo:
|
|
7
|
+
protected readonly entitiesInfo: IEntitiesInfo;
|
|
8
8
|
/**
|
|
9
9
|
* Создать мост preload-main.
|
|
10
10
|
*/
|
|
@@ -14,15 +14,17 @@ const tunnels_js_1 = __importDefault(require("../renderer/tunnels.js"));
|
|
|
14
14
|
* Мост preload-main.
|
|
15
15
|
*/
|
|
16
16
|
class PreloadBridge extends base_bridge_js_1.default {
|
|
17
|
+
entitiesInfo;
|
|
17
18
|
/**
|
|
18
19
|
* Создать мост preload-main.
|
|
19
20
|
*/
|
|
20
21
|
constructor() {
|
|
21
22
|
super();
|
|
22
|
-
|
|
23
|
-
if (!
|
|
23
|
+
const info = index_js_1.EntitiesInfo.read(electron_1.ipcRenderer.sendSync(index_js_1.IpcChannel.publicInfo.get()));
|
|
24
|
+
if (!info) {
|
|
24
25
|
throw new errors_js_1.NotProvidedFromMainError();
|
|
25
26
|
}
|
|
27
|
+
this.entitiesInfo = info;
|
|
26
28
|
this.init();
|
|
27
29
|
}
|
|
28
30
|
callFunction(name, secret, args) {
|
|
@@ -44,11 +46,10 @@ class PreloadBridge extends base_bridge_js_1.default {
|
|
|
44
46
|
: tunnel.once(listener);
|
|
45
47
|
}
|
|
46
48
|
emitEvent(name, value) {
|
|
49
|
+
index_js_1.Names.validateEvent(name);
|
|
47
50
|
const tunnel = new tunnels_js_1.default.Event(name);
|
|
48
|
-
if (value
|
|
49
|
-
value
|
|
50
|
-
.then(val => tunnel.emit(index_js_1.Transfer.toTransferable(val)))
|
|
51
|
-
.catch(reason => tunnel.error(String(reason)));
|
|
51
|
+
if (index_js_1.Transfer.isPromiseLike(value)) {
|
|
52
|
+
value.then(result => tunnel.emit(index_js_1.Transfer.toTransferable(result)), reason => tunnel.error(reason));
|
|
52
53
|
}
|
|
53
54
|
else {
|
|
54
55
|
tunnel.emit(value);
|
|
@@ -7,6 +7,13 @@ const electron_1 = require("electron");
|
|
|
7
7
|
const errors_js_1 = require("../../errors.js");
|
|
8
8
|
const index_js_1 = require("../helpers/index.js");
|
|
9
9
|
const tunnels_js_1 = __importDefault(require("../renderer/tunnels.js"));
|
|
10
|
+
/**
|
|
11
|
+
* Максимальное число отслеживаемых каналов обещаний.
|
|
12
|
+
*
|
|
13
|
+
* Защищает от роста множества, если renderer вызывает функции,
|
|
14
|
+
* но никогда не ожидает их результат.
|
|
15
|
+
*/
|
|
16
|
+
const MAX_PENDING_PROMISES = 1024;
|
|
10
17
|
/**
|
|
11
18
|
* Бросить ошибку если есть повод.
|
|
12
19
|
*/
|
|
@@ -17,6 +24,17 @@ if (!electron_1.ipcRenderer) {
|
|
|
17
24
|
else if (!electron_1.contextBridge) {
|
|
18
25
|
throwPossibleError = index_js_1.Errors.getThrower(errors_js_1.TryProvideInRendererError);
|
|
19
26
|
}
|
|
27
|
+
/**
|
|
28
|
+
* Был ли провайдер уже добавлен.
|
|
29
|
+
*/
|
|
30
|
+
let isProvided = false;
|
|
31
|
+
/**
|
|
32
|
+
* Каналы обещаний, выданные текущим вызовам.
|
|
33
|
+
*
|
|
34
|
+
* `waitPromise` доступен странице, поэтому он не должен позволять
|
|
35
|
+
* подписываться на произвольные IPC-каналы main процесса.
|
|
36
|
+
*/
|
|
37
|
+
const pendingPromiseChannels = new Set();
|
|
20
38
|
/**
|
|
21
39
|
* Добавляет необходимые для работы функции.
|
|
22
40
|
*
|
|
@@ -24,32 +42,74 @@ else if (!electron_1.contextBridge) {
|
|
|
24
42
|
*/
|
|
25
43
|
function provideFromMain(contextIsolation = true) {
|
|
26
44
|
throwPossibleError();
|
|
27
|
-
|
|
45
|
+
if (isProvided) {
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
const entitiesInfo = index_js_1.EntitiesInfo.read(electron_1.ipcRenderer.sendSync(index_js_1.IpcChannel.publicInfo.get()));
|
|
28
49
|
if (!entitiesInfo) {
|
|
29
50
|
throw new errors_js_1.NotProvidedFromMainError();
|
|
30
51
|
}
|
|
31
52
|
const provider = {
|
|
32
|
-
getEntitiesInfo: () =>
|
|
33
|
-
|
|
34
|
-
.
|
|
35
|
-
|
|
53
|
+
getEntitiesInfo: () => ({
|
|
54
|
+
variables: new Set(entitiesInfo.variables),
|
|
55
|
+
functions: new Set(entitiesInfo.functions)
|
|
56
|
+
}),
|
|
57
|
+
waitPromise: (channel, resolve, reject, id) => {
|
|
58
|
+
if (!pendingPromiseChannels.has(channel)) {
|
|
59
|
+
const error = new Error(`Неизвестный канал обещания '${String(channel)}'.`);
|
|
60
|
+
if (typeof reject === 'function') {
|
|
61
|
+
reject(error);
|
|
62
|
+
}
|
|
63
|
+
else {
|
|
64
|
+
console.error(error);
|
|
65
|
+
}
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
pendingPromiseChannels.delete(channel);
|
|
69
|
+
new tunnels_js_1.default.Promise(channel).wait(id).then(value => {
|
|
70
|
+
try {
|
|
71
|
+
resolve(value);
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
console.error(error);
|
|
75
|
+
}
|
|
76
|
+
}, reason => {
|
|
77
|
+
if (typeof reject !== 'function') {
|
|
78
|
+
console.error(reason);
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
try {
|
|
82
|
+
reject(reason);
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
console.error(error);
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
},
|
|
36
89
|
entities: {
|
|
37
|
-
functions: getFunctions(),
|
|
38
|
-
variables: getVariables(),
|
|
90
|
+
functions: getFunctions(entitiesInfo),
|
|
91
|
+
variables: getVariables(entitiesInfo),
|
|
39
92
|
events: {
|
|
40
93
|
emit: (name, value) => {
|
|
94
|
+
index_js_1.Names.validateEvent(name);
|
|
41
95
|
const tunnel = new tunnels_js_1.default.Event(name);
|
|
42
|
-
if (value
|
|
43
|
-
value
|
|
44
|
-
.then(val => tunnel.emit(index_js_1.Transfer.toTransferable(val)))
|
|
45
|
-
.catch(reason => tunnel.error(String(reason)));
|
|
96
|
+
if (index_js_1.Transfer.isPromiseLike(value)) {
|
|
97
|
+
value.then(result => tunnel.emit(index_js_1.Transfer.toTransferable(result)), reason => tunnel.error(reason));
|
|
46
98
|
}
|
|
47
99
|
else {
|
|
48
100
|
tunnel.emit(value);
|
|
49
101
|
}
|
|
50
102
|
},
|
|
51
|
-
on: (name, listener) =>
|
|
52
|
-
|
|
103
|
+
on: (name, listener) => {
|
|
104
|
+
index_js_1.Names.validateEvent(name);
|
|
105
|
+
assertListener(listener);
|
|
106
|
+
return new tunnels_js_1.default.Event(name).on(listener);
|
|
107
|
+
},
|
|
108
|
+
once: (name, listener) => {
|
|
109
|
+
index_js_1.Names.validateEvent(name);
|
|
110
|
+
assertListener(listener);
|
|
111
|
+
return new tunnels_js_1.default.Event(name).once(listener);
|
|
112
|
+
}
|
|
53
113
|
}
|
|
54
114
|
}
|
|
55
115
|
};
|
|
@@ -57,26 +117,39 @@ function provideFromMain(contextIsolation = true) {
|
|
|
57
117
|
electron_1.contextBridge.exposeInMainWorld('__provider__', provider);
|
|
58
118
|
}
|
|
59
119
|
else {
|
|
120
|
+
if (typeof window === 'undefined') {
|
|
121
|
+
throw new errors_js_1.TryProvideInRendererError();
|
|
122
|
+
}
|
|
60
123
|
window.__provider__ = provider;
|
|
61
124
|
}
|
|
125
|
+
isProvided = true;
|
|
62
126
|
/**
|
|
63
127
|
* Получить доступ к публичным функциям.
|
|
128
|
+
* @param info - Информация о сущностях.
|
|
64
129
|
*/
|
|
65
|
-
function getFunctions() {
|
|
130
|
+
function getFunctions(info) {
|
|
66
131
|
const result = {};
|
|
67
|
-
for (const name of
|
|
132
|
+
for (const name of info.functions) {
|
|
68
133
|
result[name] = (id, args) => {
|
|
69
|
-
|
|
134
|
+
if (typeof id !== 'string' || !Array.isArray(args)) {
|
|
135
|
+
throw new TypeError('Некорректные аргументы вызова функции моста.');
|
|
136
|
+
}
|
|
137
|
+
const response = new tunnels_js_1.default.Function(name).call({ args, id });
|
|
138
|
+
if (index_js_1.IpcChannel.promise.is(response.promiseChannel)) {
|
|
139
|
+
rememberPromiseChannel(response.promiseChannel);
|
|
140
|
+
}
|
|
141
|
+
return response;
|
|
70
142
|
};
|
|
71
143
|
}
|
|
72
144
|
return result;
|
|
73
145
|
}
|
|
74
146
|
/**
|
|
75
147
|
* Получить доступ к публичным переменным.
|
|
148
|
+
* @param info - Информация о сущностях.
|
|
76
149
|
*/
|
|
77
|
-
function getVariables() {
|
|
150
|
+
function getVariables(info) {
|
|
78
151
|
const result = {};
|
|
79
|
-
for (const name of
|
|
152
|
+
for (const name of info.variables) {
|
|
80
153
|
const tunnel = new tunnels_js_1.default.Variable(name);
|
|
81
154
|
result[name] = {
|
|
82
155
|
get: () => tunnel.get(),
|
|
@@ -86,4 +159,26 @@ function provideFromMain(contextIsolation = true) {
|
|
|
86
159
|
return result;
|
|
87
160
|
}
|
|
88
161
|
}
|
|
162
|
+
/**
|
|
163
|
+
* Запомнить выданный канал обещания.
|
|
164
|
+
* @param channel - Канал.
|
|
165
|
+
*/
|
|
166
|
+
function rememberPromiseChannel(channel) {
|
|
167
|
+
if (pendingPromiseChannels.size >= MAX_PENDING_PROMISES) {
|
|
168
|
+
const oldest = pendingPromiseChannels.values().next().value;
|
|
169
|
+
if (oldest !== undefined) {
|
|
170
|
+
pendingPromiseChannels.delete(oldest);
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
pendingPromiseChannels.add(channel);
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Проверить, что обработчик события является функцией.
|
|
177
|
+
* @param listener - Обработчик.
|
|
178
|
+
*/
|
|
179
|
+
function assertListener(listener) {
|
|
180
|
+
if (typeof listener !== 'function') {
|
|
181
|
+
throw new TypeError('Обработчик события должен быть функцией.');
|
|
182
|
+
}
|
|
183
|
+
}
|
|
89
184
|
exports.default = provideFromMain;
|
|
@@ -10,6 +10,11 @@ const base_bridge_js_1 = __importDefault(require("../base-bridge.js"));
|
|
|
10
10
|
* Мост renderer-main.
|
|
11
11
|
*/
|
|
12
12
|
class RendererBridge extends base_bridge_js_1.default {
|
|
13
|
+
/**
|
|
14
|
+
* Провайдер необходимых функций.
|
|
15
|
+
*/
|
|
16
|
+
globalProvider;
|
|
17
|
+
entitiesInfo;
|
|
13
18
|
constructor() {
|
|
14
19
|
super();
|
|
15
20
|
if (!index_js_1.Env.hasProvider) {
|
|
@@ -70,6 +70,9 @@ declare class PromiseTunnel {
|
|
|
70
70
|
* Туннель для события.
|
|
71
71
|
*/
|
|
72
72
|
declare class EventTunnel {
|
|
73
|
+
/**
|
|
74
|
+
* Имя события.
|
|
75
|
+
*/
|
|
73
76
|
private readonly name;
|
|
74
77
|
/**
|
|
75
78
|
* Туннель вызова события.
|
|
@@ -83,6 +86,10 @@ declare class EventTunnel {
|
|
|
83
86
|
* Туннель однократной обработки события.
|
|
84
87
|
*/
|
|
85
88
|
private readonly onceTunnel;
|
|
89
|
+
/**
|
|
90
|
+
* Туннель отписки от события.
|
|
91
|
+
*/
|
|
92
|
+
private readonly offTunnel;
|
|
86
93
|
/**
|
|
87
94
|
* Создать туннель для события.
|
|
88
95
|
* @param name - Имя события.
|
|
@@ -109,13 +116,19 @@ declare class EventTunnel {
|
|
|
109
116
|
* Бросить ошибку.
|
|
110
117
|
* @param error - Ошибка.
|
|
111
118
|
*/
|
|
112
|
-
error(error:
|
|
119
|
+
error(error: unknown): void;
|
|
120
|
+
/**
|
|
121
|
+
* Подписаться на событие.
|
|
122
|
+
* @param listener - Обработчик события.
|
|
123
|
+
* @param isOnce - Одноразовая подписка.
|
|
124
|
+
* @returns Функция отписки от события.
|
|
125
|
+
*/
|
|
126
|
+
private subscribe;
|
|
113
127
|
}
|
|
114
128
|
/**
|
|
115
129
|
* IPC туннель.
|
|
116
130
|
*/
|
|
117
131
|
export default class IPCTunnel {
|
|
118
|
-
private channel;
|
|
119
132
|
/**
|
|
120
133
|
* Туннель для функции.
|
|
121
134
|
*/
|
|
@@ -132,6 +145,10 @@ export default class IPCTunnel {
|
|
|
132
145
|
* Туннель для события.
|
|
133
146
|
*/
|
|
134
147
|
static readonly Event: typeof EventTunnel;
|
|
148
|
+
/**
|
|
149
|
+
* Канал.
|
|
150
|
+
*/
|
|
151
|
+
private readonly channel;
|
|
135
152
|
/**
|
|
136
153
|
* Создать IPC туннель.
|
|
137
154
|
* @param channel - Канал.
|
|
@@ -6,11 +6,16 @@ const index_js_1 = require("../helpers/index.js");
|
|
|
6
6
|
* IPC туннель для функции.
|
|
7
7
|
*/
|
|
8
8
|
class FunctionTunnel {
|
|
9
|
+
/**
|
|
10
|
+
* Туннель.
|
|
11
|
+
*/
|
|
12
|
+
tunnel;
|
|
9
13
|
/**
|
|
10
14
|
* Создать IPC туннель для функции.
|
|
11
15
|
* @param name - Имя функции.
|
|
12
16
|
*/
|
|
13
17
|
constructor(name) {
|
|
18
|
+
index_js_1.Names.validateEntity(name);
|
|
14
19
|
this.tunnel = new IPCTunnel(index_js_1.IpcChannel.func.call(name));
|
|
15
20
|
}
|
|
16
21
|
/**
|
|
@@ -26,11 +31,20 @@ class FunctionTunnel {
|
|
|
26
31
|
* Туннель для переменной.
|
|
27
32
|
*/
|
|
28
33
|
class VariableTunnel {
|
|
34
|
+
/**
|
|
35
|
+
* Туннель для получения значения.
|
|
36
|
+
*/
|
|
37
|
+
getTunnel;
|
|
38
|
+
/**
|
|
39
|
+
* Туннель для установки значения.
|
|
40
|
+
*/
|
|
41
|
+
setTunnel;
|
|
29
42
|
/**
|
|
30
43
|
* Создать туннель для переменной.
|
|
31
44
|
* @param name - Имя переменной.
|
|
32
45
|
*/
|
|
33
46
|
constructor(name) {
|
|
47
|
+
index_js_1.Names.validateEntity(name);
|
|
34
48
|
this.getTunnel = new IPCTunnel(index_js_1.IpcChannel.prop.get(name));
|
|
35
49
|
this.setTunnel = new IPCTunnel(index_js_1.IpcChannel.prop.set(name));
|
|
36
50
|
}
|
|
@@ -52,6 +66,10 @@ class VariableTunnel {
|
|
|
52
66
|
* Туннель для обработки обещания.
|
|
53
67
|
*/
|
|
54
68
|
class PromiseTunnel {
|
|
69
|
+
/**
|
|
70
|
+
* Туннель.
|
|
71
|
+
*/
|
|
72
|
+
tunnel;
|
|
55
73
|
/**
|
|
56
74
|
* Создать туннель для обработки обещания.
|
|
57
75
|
* @param channel - Канал возвращающий обещание.
|
|
@@ -65,17 +83,21 @@ class PromiseTunnel {
|
|
|
65
83
|
*/
|
|
66
84
|
wait(id) {
|
|
67
85
|
return new Promise((resolve, reject) => {
|
|
68
|
-
const handler = (_,
|
|
69
|
-
|
|
86
|
+
const handler = (_, payload) => {
|
|
87
|
+
const result = index_js_1.IpcPayload.result(payload);
|
|
88
|
+
if (!result) {
|
|
89
|
+
return;
|
|
90
|
+
}
|
|
91
|
+
if (id !== undefined && result.id !== id) {
|
|
70
92
|
return;
|
|
71
93
|
}
|
|
72
|
-
|
|
73
|
-
|
|
94
|
+
this.tunnel.removeListener(handler);
|
|
95
|
+
if (result.error) {
|
|
96
|
+
reject(result.error);
|
|
74
97
|
}
|
|
75
98
|
else {
|
|
76
|
-
resolve(value);
|
|
99
|
+
resolve(result.value);
|
|
77
100
|
}
|
|
78
|
-
this.tunnel.removeListener(handler);
|
|
79
101
|
};
|
|
80
102
|
this.tunnel.on(handler);
|
|
81
103
|
});
|
|
@@ -85,15 +107,37 @@ class PromiseTunnel {
|
|
|
85
107
|
* Туннель для события.
|
|
86
108
|
*/
|
|
87
109
|
class EventTunnel {
|
|
110
|
+
/**
|
|
111
|
+
* Имя события.
|
|
112
|
+
*/
|
|
113
|
+
name;
|
|
114
|
+
/**
|
|
115
|
+
* Туннель вызова события.
|
|
116
|
+
*/
|
|
117
|
+
emitTunnel;
|
|
118
|
+
/**
|
|
119
|
+
* Туннель обработки события.
|
|
120
|
+
*/
|
|
121
|
+
onTunnel;
|
|
122
|
+
/**
|
|
123
|
+
* Туннель однократной обработки события.
|
|
124
|
+
*/
|
|
125
|
+
onceTunnel;
|
|
126
|
+
/**
|
|
127
|
+
* Туннель отписки от события.
|
|
128
|
+
*/
|
|
129
|
+
offTunnel;
|
|
88
130
|
/**
|
|
89
131
|
* Создать туннель для события.
|
|
90
132
|
* @param name - Имя события.
|
|
91
133
|
*/
|
|
92
134
|
constructor(name) {
|
|
135
|
+
index_js_1.Names.validateEvent(name);
|
|
93
136
|
this.name = name;
|
|
94
137
|
this.emitTunnel = new IPCTunnel(index_js_1.IpcChannel.event.emit(name));
|
|
95
138
|
this.onTunnel = new IPCTunnel(index_js_1.IpcChannel.event.on());
|
|
96
139
|
this.onceTunnel = new IPCTunnel(index_js_1.IpcChannel.event.once());
|
|
140
|
+
this.offTunnel = new IPCTunnel(index_js_1.IpcChannel.event.off());
|
|
97
141
|
}
|
|
98
142
|
/**
|
|
99
143
|
* Добавить обработчик события.
|
|
@@ -101,10 +145,7 @@ class EventTunnel {
|
|
|
101
145
|
* @returns Функция отписки от события.
|
|
102
146
|
*/
|
|
103
147
|
on(listener) {
|
|
104
|
-
|
|
105
|
-
this.onTunnel.response(index_js_1.IpcResult.createWithValue(this.name));
|
|
106
|
-
this.emitTunnel.on(handler);
|
|
107
|
-
return () => this.emitTunnel.removeListener(handler);
|
|
148
|
+
return this.subscribe(listener, false);
|
|
108
149
|
}
|
|
109
150
|
/**
|
|
110
151
|
* Добавить одноразовый обработчик события.
|
|
@@ -112,10 +153,7 @@ class EventTunnel {
|
|
|
112
153
|
* @returns Функция отписки от события.
|
|
113
154
|
*/
|
|
114
155
|
once(listener) {
|
|
115
|
-
|
|
116
|
-
this.onceTunnel.response(index_js_1.IpcResult.createWithValue(this.name));
|
|
117
|
-
this.emitTunnel.once(handler);
|
|
118
|
-
return () => this.emitTunnel.removeListener(handler);
|
|
156
|
+
return this.subscribe(listener, true);
|
|
119
157
|
}
|
|
120
158
|
/**
|
|
121
159
|
* Вызвать событие.
|
|
@@ -129,13 +167,88 @@ class EventTunnel {
|
|
|
129
167
|
* @param error - Ошибка.
|
|
130
168
|
*/
|
|
131
169
|
error(error) {
|
|
132
|
-
this.emitTunnel.response(
|
|
170
|
+
this.emitTunnel.response(index_js_1.IpcResult.createWithError(error));
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Подписаться на событие.
|
|
174
|
+
* @param listener - Обработчик события.
|
|
175
|
+
* @param isOnce - Одноразовая подписка.
|
|
176
|
+
* @returns Функция отписки от события.
|
|
177
|
+
*/
|
|
178
|
+
subscribe(listener, isOnce) {
|
|
179
|
+
if (typeof listener !== 'function') {
|
|
180
|
+
throw new TypeError('Обработчик события должен быть функцией.');
|
|
181
|
+
}
|
|
182
|
+
const handler = (_, payload) => {
|
|
183
|
+
const result = index_js_1.IpcPayload.result(payload);
|
|
184
|
+
if (result) {
|
|
185
|
+
listener(result);
|
|
186
|
+
}
|
|
187
|
+
};
|
|
188
|
+
if (isOnce) {
|
|
189
|
+
this.emitTunnel.once(handler);
|
|
190
|
+
}
|
|
191
|
+
else {
|
|
192
|
+
this.emitTunnel.on(handler);
|
|
193
|
+
}
|
|
194
|
+
try {
|
|
195
|
+
const registration = index_js_1.IpcResult.createWithValue(this.name);
|
|
196
|
+
if (isOnce) {
|
|
197
|
+
this.onceTunnel.response(registration);
|
|
198
|
+
}
|
|
199
|
+
else {
|
|
200
|
+
this.onTunnel.response(registration);
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
catch (error) {
|
|
204
|
+
this.emitTunnel.removeListener(handler);
|
|
205
|
+
throw error;
|
|
206
|
+
}
|
|
207
|
+
let isActive = true;
|
|
208
|
+
return () => {
|
|
209
|
+
if (!isActive) {
|
|
210
|
+
return;
|
|
211
|
+
}
|
|
212
|
+
isActive = false;
|
|
213
|
+
this.emitTunnel.removeListener(handler);
|
|
214
|
+
// Без этого main процесс навсегда сохранял бы ссылку на
|
|
215
|
+
// `WebContents` и продолжал отправлять ему события.
|
|
216
|
+
try {
|
|
217
|
+
this.offTunnel.response({
|
|
218
|
+
value: this.name,
|
|
219
|
+
type: isOnce ? 'once' : 'on'
|
|
220
|
+
});
|
|
221
|
+
}
|
|
222
|
+
catch {
|
|
223
|
+
// Renderer уже завершается — отписываться больше некуда.
|
|
224
|
+
}
|
|
225
|
+
};
|
|
133
226
|
}
|
|
134
227
|
}
|
|
135
228
|
/**
|
|
136
229
|
* IPC туннель.
|
|
137
230
|
*/
|
|
138
231
|
class IPCTunnel {
|
|
232
|
+
/**
|
|
233
|
+
* Туннель для функции.
|
|
234
|
+
*/
|
|
235
|
+
static Function = FunctionTunnel;
|
|
236
|
+
/**
|
|
237
|
+
* Туннель для переменной.
|
|
238
|
+
*/
|
|
239
|
+
static Variable = VariableTunnel;
|
|
240
|
+
/**
|
|
241
|
+
* Туннель для обещания.
|
|
242
|
+
*/
|
|
243
|
+
static Promise = PromiseTunnel;
|
|
244
|
+
/**
|
|
245
|
+
* Туннель для события.
|
|
246
|
+
*/
|
|
247
|
+
static Event = EventTunnel;
|
|
248
|
+
/**
|
|
249
|
+
* Канал.
|
|
250
|
+
*/
|
|
251
|
+
channel;
|
|
139
252
|
/**
|
|
140
253
|
* Создать IPC туннель.
|
|
141
254
|
* @param channel - Канал.
|
|
@@ -149,7 +262,11 @@ class IPCTunnel {
|
|
|
149
262
|
* @returns Результат запроса.
|
|
150
263
|
*/
|
|
151
264
|
request(args = { args: [] }) {
|
|
152
|
-
|
|
265
|
+
const result = index_js_1.IpcPayload.result(electron_1.ipcRenderer.sendSync(this.channel, args));
|
|
266
|
+
if (!result) {
|
|
267
|
+
return index_js_1.IpcResult.createWithError(new Error(`Нет ответа по каналу '${this.channel}'.`));
|
|
268
|
+
}
|
|
269
|
+
return result;
|
|
153
270
|
}
|
|
154
271
|
/**
|
|
155
272
|
* Отправить ответ.
|
|
@@ -186,20 +303,4 @@ class IPCTunnel {
|
|
|
186
303
|
electron_1.ipcRenderer.removeAllListeners(this.channel);
|
|
187
304
|
}
|
|
188
305
|
}
|
|
189
|
-
/**
|
|
190
|
-
* Туннель для функции.
|
|
191
|
-
*/
|
|
192
|
-
IPCTunnel.Function = FunctionTunnel;
|
|
193
|
-
/**
|
|
194
|
-
* Туннель для переменной.
|
|
195
|
-
*/
|
|
196
|
-
IPCTunnel.Variable = VariableTunnel;
|
|
197
|
-
/**
|
|
198
|
-
* Туннель для обещания.
|
|
199
|
-
*/
|
|
200
|
-
IPCTunnel.Promise = PromiseTunnel;
|
|
201
|
-
/**
|
|
202
|
-
* Туннель для события.
|
|
203
|
-
*/
|
|
204
|
-
IPCTunnel.Event = EventTunnel;
|
|
205
306
|
exports.default = IPCTunnel;
|
package/cjs/types.d.ts
CHANGED
package/esm/entries/index.d.ts
CHANGED
package/esm/entries/index.js
CHANGED
|
@@ -2,4 +2,8 @@
|
|
|
2
2
|
Главная точка входа.
|
|
3
3
|
Экспорт только типов потому что одновременный импорт для разных процессов приводит к ошибке.
|
|
4
4
|
*/
|
|
5
|
-
|
|
5
|
+
/*
|
|
6
|
+
Ошибки не зависят от процессов, поэтому их можно безопасно
|
|
7
|
+
экспортировать из общей точки входа.
|
|
8
|
+
*/
|
|
9
|
+
export * from '../errors.js';
|
package/esm/errors.d.ts
CHANGED
|
@@ -58,3 +58,21 @@ export declare class TryProvideInMainError extends Error {
|
|
|
58
58
|
export declare class TryProvideInRendererError extends Error {
|
|
59
59
|
constructor();
|
|
60
60
|
}
|
|
61
|
+
/**
|
|
62
|
+
* Некорректное имя публикуемой сущности.
|
|
63
|
+
*/
|
|
64
|
+
export declare class InvalidEntityNameError extends Error {
|
|
65
|
+
constructor(name: unknown, reserved?: boolean);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Некорректное имя события.
|
|
69
|
+
*/
|
|
70
|
+
export declare class InvalidEventNameError extends Error {
|
|
71
|
+
constructor(name: unknown);
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Нет ответа от main процесса.
|
|
75
|
+
*/
|
|
76
|
+
export declare class NoResponseFromMainError extends Error {
|
|
77
|
+
constructor(channel: string);
|
|
78
|
+
}
|
package/esm/errors.js
CHANGED
|
@@ -78,3 +78,33 @@ export class TryProvideInRendererError extends Error {
|
|
|
78
78
|
super('"provideFromMain" недоступен в renderer процессе.');
|
|
79
79
|
}
|
|
80
80
|
}
|
|
81
|
+
/**
|
|
82
|
+
* Некорректное имя публикуемой сущности.
|
|
83
|
+
*/
|
|
84
|
+
export class InvalidEntityNameError extends Error {
|
|
85
|
+
constructor(name, reserved = false) {
|
|
86
|
+
const reason = reserved
|
|
87
|
+
? 'Имя зарезервировано мостом.'
|
|
88
|
+
: 'Имя должно быть непустой строкой допустимой длины.';
|
|
89
|
+
super(`Некорректное имя сущности '${String(name)}'. ${reason}`);
|
|
90
|
+
this.name = 'InvalidEntityNameError';
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Некорректное имя события.
|
|
95
|
+
*/
|
|
96
|
+
export class InvalidEventNameError extends Error {
|
|
97
|
+
constructor(name) {
|
|
98
|
+
super(`Некорректное имя события '${String(name)}'. Имя должно быть непустой строкой допустимой длины.`);
|
|
99
|
+
this.name = 'InvalidEventNameError';
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Нет ответа от main процесса.
|
|
104
|
+
*/
|
|
105
|
+
export class NoResponseFromMainError extends Error {
|
|
106
|
+
constructor(channel) {
|
|
107
|
+
super(`Нет ответа от main процесса по каналу '${channel}'.`);
|
|
108
|
+
this.name = 'NoResponseFromMainError';
|
|
109
|
+
}
|
|
110
|
+
}
|