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.
Files changed (75) hide show
  1. package/README.md +8 -0
  2. package/cjs/entries/index.d.ts +1 -0
  3. package/cjs/entries/index.js +19 -0
  4. package/cjs/errors.d.ts +18 -0
  5. package/cjs/errors.js +34 -1
  6. package/cjs/package.json +3 -0
  7. package/cjs/scripts/base-bridge.d.ts +15 -8
  8. package/cjs/scripts/base-bridge.js +88 -42
  9. package/cjs/scripts/helpers/entities-info.d.ts +20 -0
  10. package/cjs/scripts/helpers/entities-info.js +38 -0
  11. package/cjs/scripts/helpers/env.js +1 -1
  12. package/cjs/scripts/helpers/id.d.ts +9 -0
  13. package/cjs/scripts/helpers/id.js +15 -1
  14. package/cjs/scripts/helpers/index.d.ts +3 -0
  15. package/cjs/scripts/helpers/index.js +7 -1
  16. package/cjs/scripts/helpers/ipc-channel.d.ts +10 -0
  17. package/cjs/scripts/helpers/ipc-channel.js +73 -61
  18. package/cjs/scripts/helpers/ipc-event-in-main.d.ts +7 -1
  19. package/cjs/scripts/helpers/ipc-event-in-main.js +27 -2
  20. package/cjs/scripts/helpers/ipc-payload.d.ts +38 -0
  21. package/cjs/scripts/helpers/ipc-payload.js +82 -0
  22. package/cjs/scripts/helpers/ipc-result.d.ts +9 -1
  23. package/cjs/scripts/helpers/ipc-result.js +32 -9
  24. package/cjs/scripts/helpers/names.d.ts +20 -0
  25. package/cjs/scripts/helpers/names.js +77 -0
  26. package/cjs/scripts/helpers/transfer.d.ts +8 -0
  27. package/cjs/scripts/helpers/transfer.js +24 -10
  28. package/cjs/scripts/helpers/web-contents-events-container.d.ts +57 -8
  29. package/cjs/scripts/helpers/web-contents-events-container.js +150 -25
  30. package/cjs/scripts/main/publish.d.ts +2 -2
  31. package/cjs/scripts/main/publish.js +177 -78
  32. package/cjs/scripts/preload/bridge.d.ts +2 -2
  33. package/cjs/scripts/preload/bridge.js +7 -6
  34. package/cjs/scripts/preload/provider.js +113 -18
  35. package/cjs/scripts/renderer/bridge.js +5 -0
  36. package/cjs/scripts/renderer/tunnels.d.ts +19 -2
  37. package/cjs/scripts/renderer/tunnels.js +133 -32
  38. package/cjs/types.d.ts +4 -0
  39. package/esm/entries/index.d.ts +1 -0
  40. package/esm/entries/index.js +5 -1
  41. package/esm/errors.d.ts +18 -0
  42. package/esm/errors.js +30 -0
  43. package/esm/scripts/base-bridge.d.ts +15 -8
  44. package/esm/scripts/base-bridge.js +90 -44
  45. package/esm/scripts/helpers/entities-info.d.ts +20 -0
  46. package/esm/scripts/helpers/entities-info.js +35 -0
  47. package/esm/scripts/helpers/env.js +1 -1
  48. package/esm/scripts/helpers/id.d.ts +9 -0
  49. package/esm/scripts/helpers/id.js +15 -1
  50. package/esm/scripts/helpers/index.d.ts +3 -0
  51. package/esm/scripts/helpers/index.js +3 -0
  52. package/esm/scripts/helpers/ipc-channel.d.ts +10 -0
  53. package/esm/scripts/helpers/ipc-channel.js +74 -63
  54. package/esm/scripts/helpers/ipc-event-in-main.d.ts +7 -1
  55. package/esm/scripts/helpers/ipc-event-in-main.js +24 -2
  56. package/esm/scripts/helpers/ipc-payload.d.ts +38 -0
  57. package/esm/scripts/helpers/ipc-payload.js +79 -0
  58. package/esm/scripts/helpers/ipc-result.d.ts +9 -1
  59. package/esm/scripts/helpers/ipc-result.js +32 -9
  60. package/esm/scripts/helpers/names.d.ts +20 -0
  61. package/esm/scripts/helpers/names.js +74 -0
  62. package/esm/scripts/helpers/transfer.d.ts +8 -0
  63. package/esm/scripts/helpers/transfer.js +24 -10
  64. package/esm/scripts/helpers/web-contents-events-container.d.ts +57 -8
  65. package/esm/scripts/helpers/web-contents-events-container.js +150 -25
  66. package/esm/scripts/main/publish.d.ts +2 -2
  67. package/esm/scripts/main/publish.js +179 -80
  68. package/esm/scripts/preload/bridge.d.ts +2 -2
  69. package/esm/scripts/preload/bridge.js +8 -7
  70. package/esm/scripts/preload/provider.js +114 -19
  71. package/esm/scripts/renderer/bridge.js +5 -0
  72. package/esm/scripts/renderer/tunnels.d.ts +19 -2
  73. package/esm/scripts/renderer/tunnels.js +135 -35
  74. package/esm/types.d.ts +4 -0
  75. 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: (name: string, value: any) => void;
16
- on: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
17
- once: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
18
- call: (func: any, Class: any, args: unknown[]) => any;
19
- returns: (func: any, Class: any) => any;
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: Parameters<TFunc>): InstanceType<TClass>;
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
- constructor() {
8
- /**
9
- * Объект, который будет использоваться пользователем.
10
- */
11
- this.target = {
12
- as: () => this.as(),
13
- emit: (...args) => this.emit(...args),
14
- on: (...args) => this.on(...args),
15
- once: (...args) => this.once(...args),
16
- call: (...args) => this.call(...args),
17
- returns: (...args) => this.returns(...args)
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
- return this.handleEvent(name, 'on', ({ value, error }) => {
28
- this.handlePossibleError(`event: ${name}`, error);
29
- listener(value);
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
- return this.handleEvent(name, 'once', ({ value, error }) => {
34
- this.handlePossibleError(`event: ${name}`, error);
35
- listener(value);
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.initFunctions();
53
- this.initVariables();
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
- throw new Error(`Error on ${channel}.\n${error}`.replace('Error: ', ''));
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 this.entitiesInfo.functions) {
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 { error, promiseChannel, value } = this.callFunction(name, id, preparedArgs);
78
- this.handlePossibleError(name, error);
79
- return promiseChannel
80
- ? this.waitPromise(promiseChannel, id)
81
- : value;
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 this.entitiesInfo.variables) {
114
+ initVariables(variables) {
115
+ for (const name of variables ?? []) {
116
+ Names.validateEntity(name);
91
117
  this.define(name, {
92
118
  get: () => {
93
- const { error, value } = this.getVariable(name);
94
- this.handlePossibleError(name, error);
95
- return value;
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 { error } = this.setVariable(name, value);
99
- this.handlePossibleError(name, error);
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
- const hasValue = Boolean(descriptor?.value);
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?.get || Errors.getThrower(NoGetAccessError, name),
118
- set: descriptor?.set || Errors.getThrower(TrySetReadonlyError, name),
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
- return Math.random().toString();
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
- on: () => 'EVENT_ON',
8
+ static publicInfo = {
9
+ /**
10
+ * Получить канал получения информации.
11
+ * @returns Канал получения информации
12
+ */
13
+ get: () => 'GET_PUBLIC_INFO'
14
+ };
36
15
  /**
37
- * Получить канал однократного отслеживания события.
38
- * @returns Канал однократного отслеживания события.
16
+ * Публичная функция.
39
17
  */
40
- once: () => 'EVENT_ONCE',
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
- emit: (name) => `EVENT_EMIT_${name}`
47
- };
48
- /**
49
- * Публичное свойство.
50
- */
51
- IpcChannel.prop = {
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
- get: (name) => `PROPERTY_GET_${name}`,
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
- set: (name) => `PROPERTY_SET_${name}`
64
- };
65
- /**
66
- * Обещание.
67
- */
68
- IpcChannel.promise = {
69
- /**
70
- * Получить канал обработки обещания.
71
- * @param channel - Канал, который возвращает обещание.
72
- * @returns Канал обработки обещания.
73
- */
74
- get: (channel) => `${channel}_PROMISE`
75
- };
76
- export default IpcChannel;
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
- private event;
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.send(channel, result);
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
- this.event.returnValue = value;
42
+ try {
43
+ this.event.returnValue = value;
44
+ }
45
+ catch (error) {
46
+ this.event.returnValue = IpcResult.createWithError(error);
47
+ }
26
48
  }
27
49
  }