@webext-core/messaging 2.1.0 → 2.2.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 +2 -2
- package/lib/index.cjs +10 -3
- package/lib/index.d.ts +19 -9
- package/lib/index.global.js +10 -3
- package/lib/index.js +10 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,10 +4,10 @@ A light-weight, type-safe wrapper around the `browser.runtime` messaging APIs. S
|
|
|
4
4
|
|
|
5
5
|
```ts
|
|
6
6
|
// ./messaging.ts
|
|
7
|
-
import {
|
|
7
|
+
import { defineExtensionMessaging } from '@webext-core/messaging';
|
|
8
8
|
|
|
9
9
|
interface ProtocolMap {
|
|
10
|
-
getStringLength:
|
|
10
|
+
getStringLength(s: string): number;
|
|
11
11
|
}
|
|
12
12
|
|
|
13
13
|
export const { sendMessage, onMessage } = defineExtensionMessaging<ProtocolMap>();
|
package/lib/index.cjs
CHANGED
|
@@ -174,10 +174,17 @@ function defineGenericMessanging(config) {
|
|
|
174
174
|
// src/extension.ts
|
|
175
175
|
function defineExtensionMessaging(config) {
|
|
176
176
|
return defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
|
|
177
|
-
sendMessage(message,
|
|
178
|
-
if (
|
|
177
|
+
sendMessage(message, arg) {
|
|
178
|
+
if (arg == null) {
|
|
179
179
|
return import_webextension_polyfill.default.runtime.sendMessage(message);
|
|
180
|
-
|
|
180
|
+
}
|
|
181
|
+
const options = typeof arg === "number" ? { tabId: arg } : arg;
|
|
182
|
+
return import_webextension_polyfill.default.tabs.sendMessage(
|
|
183
|
+
options.tabId,
|
|
184
|
+
message,
|
|
185
|
+
// Pass frameId if specified
|
|
186
|
+
options.frameId != null ? { frameId: options.frameId } : void 0
|
|
187
|
+
);
|
|
181
188
|
},
|
|
182
189
|
addRootListener(processMessage) {
|
|
183
190
|
const listener = (message, sender) => {
|
package/lib/index.d.ts
CHANGED
|
@@ -18,17 +18,27 @@ interface ExtensionMessage {
|
|
|
18
18
|
sender: Runtime.MessageSender;
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
|
-
*
|
|
22
|
-
* specific tab from the background script.
|
|
23
|
-
*
|
|
24
|
-
* You cannot message between tabs directly. It must go through the background script.
|
|
21
|
+
* Options for sending a message to a specific tab/frame
|
|
25
22
|
*/
|
|
26
|
-
|
|
23
|
+
interface SendMessageOptions {
|
|
27
24
|
/**
|
|
28
|
-
* The tab to send a message to
|
|
25
|
+
* The tab to send a message to
|
|
29
26
|
*/
|
|
30
|
-
tabId
|
|
31
|
-
|
|
27
|
+
tabId: number;
|
|
28
|
+
/**
|
|
29
|
+
* The frame to send a message to. 0 represents the main frame.
|
|
30
|
+
*/
|
|
31
|
+
frameId?: number;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Send message accepts either:
|
|
35
|
+
* - No arguments to send to background
|
|
36
|
+
* - A tabId number to send to a specific tab
|
|
37
|
+
* - A SendMessageOptions object to target a specific tab and frame
|
|
38
|
+
*
|
|
39
|
+
* You cannot message between tabs directly. It must go through the background script.
|
|
40
|
+
*/
|
|
41
|
+
type ExtensionSendMessageArgs = [arg?: number | SendMessageOptions];
|
|
32
42
|
/**
|
|
33
43
|
* Messenger returned by `defineExtensionMessaging`.
|
|
34
44
|
*/
|
|
@@ -41,4 +51,4 @@ type ExtensionMessenger<TProtocolMap extends Record<string, any>> = GenericMesse
|
|
|
41
51
|
*/
|
|
42
52
|
declare function defineExtensionMessaging<TProtocolMap extends Record<string, any> = Record<string, any>>(config?: ExtensionMessagingConfig): ExtensionMessenger<TProtocolMap>;
|
|
43
53
|
|
|
44
|
-
export { BaseMessagingConfig, ExtensionMessage, ExtensionMessagingConfig, ExtensionMessenger, ExtensionSendMessageArgs, defineExtensionMessaging };
|
|
54
|
+
export { BaseMessagingConfig, ExtensionMessage, ExtensionMessagingConfig, ExtensionMessenger, ExtensionSendMessageArgs, SendMessageOptions, defineExtensionMessaging };
|
package/lib/index.global.js
CHANGED
|
@@ -1363,10 +1363,17 @@ var webExtCoreMessaging = (() => {
|
|
|
1363
1363
|
// src/extension.ts
|
|
1364
1364
|
function defineExtensionMessaging(config) {
|
|
1365
1365
|
return defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
|
|
1366
|
-
sendMessage(message,
|
|
1367
|
-
if (
|
|
1366
|
+
sendMessage(message, arg) {
|
|
1367
|
+
if (arg == null) {
|
|
1368
1368
|
return import_webextension_polyfill.default.runtime.sendMessage(message);
|
|
1369
|
-
|
|
1369
|
+
}
|
|
1370
|
+
const options = typeof arg === "number" ? { tabId: arg } : arg;
|
|
1371
|
+
return import_webextension_polyfill.default.tabs.sendMessage(
|
|
1372
|
+
options.tabId,
|
|
1373
|
+
message,
|
|
1374
|
+
// Pass frameId if specified
|
|
1375
|
+
options.frameId != null ? { frameId: options.frameId } : void 0
|
|
1376
|
+
);
|
|
1370
1377
|
},
|
|
1371
1378
|
addRootListener(processMessage) {
|
|
1372
1379
|
const listener = (message, sender) => {
|
package/lib/index.js
CHANGED
|
@@ -8,10 +8,17 @@ import {
|
|
|
8
8
|
import Browser from "webextension-polyfill";
|
|
9
9
|
function defineExtensionMessaging(config) {
|
|
10
10
|
return defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
|
|
11
|
-
sendMessage(message,
|
|
12
|
-
if (
|
|
11
|
+
sendMessage(message, arg) {
|
|
12
|
+
if (arg == null) {
|
|
13
13
|
return Browser.runtime.sendMessage(message);
|
|
14
|
-
|
|
14
|
+
}
|
|
15
|
+
const options = typeof arg === "number" ? { tabId: arg } : arg;
|
|
16
|
+
return Browser.tabs.sendMessage(
|
|
17
|
+
options.tabId,
|
|
18
|
+
message,
|
|
19
|
+
// Pass frameId if specified
|
|
20
|
+
options.frameId != null ? { frameId: options.frameId } : void 0
|
|
21
|
+
);
|
|
15
22
|
},
|
|
16
23
|
addRootListener(processMessage) {
|
|
17
24
|
const listener = (message, sender) => {
|
package/package.json
CHANGED