浏览器扩展与网页交流

55 阅读1分钟

需求分析

  • 在 Popup 中展示自定义界面(无需嵌入网页)。
  • 在 Content Script 中执行 DOM 操作(相当于打开F12运行脚本)。
  • 两者通过 Chrome API 通信,Popup 只负责交互和显示最终结果。

通信方式

有两种通信方式,一种是有 Popup 发起通信,一种是由 Content Script 发起通信,推荐使用前者。因为这和实际操作需求相符。

此外,通信方式也有两种,一种是短连接(单次通信),一种是长连接(持续通信),推荐使用后者。

由 Popup 中发起通信

Popup 核心代码如下:

// 建立通信
const [tab] = await chrome.tabs.query({ active: true, currentWindow: true })
const port = chrome.tabs.connect( tab.id, { name: "linhieng" } )
// 监听消息
port.onMessage.addListener(function (msg) {
	console.log(msg)
})

Content Script 核心代码如下:

// 监听通道
chrome.runtime.onConnect.addListener(function (port) {
    // 发送消息
    port.postMessage({ msg: `已建立通道连接,通道名为${port.name}` })
    // 获取消息
    port.onMessage.addListener(function (msg) {
        console.log(msg)
    })
})

由 Content Script 中发起通信

Content Script 核心代码如下:

// 发起通信
const port = chrome.runtime.connect({ name: "linhieng" })
// 发送消息
port.postMessage({ title: document.title })
// 监听消息
port.onMessage.addListener(function (msg) {
    console.log(msg);
})

Popup 核心代码如下(接收通信后,Popup 和 Content Script 代码都是一样的):

// 监听通道
chrome.runtime.onConnect.addListener(function (port) {
    // 发送消息
    port.postMessage({ msg: `已建立通道连接,通道名为${port.name}` })
    // 获取消息
    port.onMessage.addListener(function (msg) {
        console.log(msg)
    })
})

注意事项

更多细节自行 AI。

注意权限要求:

  • 需要在 manifest.json 中声明 "tabs" 权限。
  • Content Script 需提前注入(通过 manifest.json)。