如何在Chrome 擴充程式更新後刪除孤立腳本

問題

無意中重新載入Chrome 擴充程序，尤其是處於開發者模式的擴充程序，可能會建立孤立內容腳本。這些腳本仍然在後台運行，但與擴展的其餘部分失去了通信，從而導致諸如“擴展上下文無效”和“未檢查的運行時.lastError”之類的錯誤。

解決方案

孤立的內容腳本仍然可以接收 DOM 訊息。刪除它：

1.從新內容腳本發送訊息：

• 在新的工作內容腳本中，使用 window.dispatchEvent 向孤立腳本發送訊息。
• 使用唯一訊息標識符，例如 orphanMessageId.

2。在孤立腳本中取消註冊偵聽器：

• 在孤立腳本中，為 orphanMessageId 定義偵聽器。
• 在此偵聽器中，取消註冊所有先前偵聽器並取消全域變數。
• 這使得舊腳本符合垃圾回收條件。

3.後台腳本：

• 在擴充重新載入/安裝時重新註入內容腳本。

4。內容腳本：

• 為事件偵聽器使用命名函數以保留其參考。
• 設定 window.running 屬性以指示活動實例。
• 收到 orphanMessageId 時，取消註冊偵聽器並將腳本標記為孤立的。

5.彈出腳本：

• 在發送訊息之前檢查是否存在工作內容腳本。
• 利用ensureContentScript確保腳本注入。

範例程式碼：

background.js:

// Re-inject content script
chrome.runtime.onInstalled.addListener(() => {
  chrome.tabs.query({ active: true, currentWindow: true }, tabs => {
    chrome.tabs.executeScript(tabs[0].id, { file: 'content.js' });
  });
});

content.js:

// Orphaned script detection and cleanup
var orphanMessageId = chrome.runtime.id   'orphanCheck';
window.dispatchEvent(new Event(orphanMessageId));
window.addEventListener(orphanMessageId, unregisterOrphan);

// Register named listeners
chrome.runtime.onMessage.addListener(onMessage);
document.addEventListener('mousemove', onMouseMove);

// Orphan flag and cleanup function
window.running = true;

function unregisterOrphan() {
  if (chrome.runtime.id) {
    // Not orphaned
    return;
  }
  window.removeEventListener(orphanMessageId, unregisterOrphan);
  document.removeEventListener('mousemove', onMouseMove);
  try {
    chrome.runtime.onMessage.removeListener(onMessage);
  } catch (e) {}
  return true;
}

popup.js:

async function sendMessage(data) {
  const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
  if (await ensureContentScript(tab.id)) {
    return await chrome.tabs.sendMessage(tab.id, data);
  }
}

async function ensureContentScript(tabId) {
  try {
    const [{ result }] = await chrome.scripting.executeScript({
      target: { tabId },
      func: () => window.running === true,
    });
    if (!result) {
      await chrome.scripting.executeScript({
        target: { tabId },
        files: ['content.js'],
      });
    }
    return true;
  } catch (e) {}
}