Chrome扩展创建新窗口后executeScript报Tab Not Found错误

核心错误原因 #

你将**窗口ID（window.id）误当作标签页ID（tab.id）**使用，这是触发tab not found for id : XXXX错误的直接原因：

• chrome.windows.create的回调参数是窗口对象，其中的id是窗口的唯一标识；
• chrome.scripting.executeScript要求传入的是标签页ID，而非窗口ID，两者完全不同；
• chrome.windows.update可以使用窗口ID正常执行，是因为这个API本身就是针对窗口操作的。

修复步骤 #

1. 修正窗口创建时的ID存储逻辑 #

新建窗口默认包含一个标签页，你需要从窗口对象的tabs数组中提取标签页ID，而非直接使用窗口ID：

// Create the window at the bottom-right corner
chrome.windows.create({
    url: "https://localhost/index.html",
    focused: true,
}, function (window) {
    // 取窗口内第一个标签页的ID，而非窗口ID
    const tabId = window.tabs[0].id; 
    console.log("Window created, tab ID:", tabId);
    chrome.storage.local.set({ tabId: tabId }, function () {
        console.log("Popup tab ID stored:", tabId);
    });
});

2. 确保脚本执行的时机与正确性 #

即使确认页面已加载，仍需保证调用executeScript时使用正确的标签页ID，并可通过监听标签页状态确保脚本在页面就绪后执行：

// 从storage获取正确的标签页ID
chrome.storage.local.get('tabId', (result) => {
    const targetTabId = result.tabId;
    if (!targetTabId) return;

    // 先验证标签页是否存在
    chrome.tabs.get(targetTabId, (tab) => {
        if (chrome.runtime.lastError) {
            console.error("Tab not found:", chrome.runtime.lastError.message);
            return;
        }
        // 页面已加载完成则直接执行脚本
        if (tab.status === 'complete') {
            executeScriptOnTab(targetTabId);
        } else {
            // 监听页面加载完成事件，避免过早执行
            const listener = (tabId, changeInfo) => {
                if (tabId === targetTabId && changeInfo.status === 'complete') {
                    chrome.tabs.onUpdated.removeListener(listener);
                    executeScriptOnTab(targetTabId);
                }
            };
            chrome.tabs.onUpdated.addListener(listener);
        }
    });
});

function executeScriptOnTab(tabId) {
    chrome.scripting.executeScript({
        target: { tabId: tabId },
        func: (message) => {
            window.postMessage(message, '*');
        },
        args: [message] // 必须通过args传递外部变量到目标页面上下文
    }, () => {
        if (chrome.runtime.lastError) {
            console.error(`Script execution failed: ${chrome.runtime.lastError.message}`);
        } else {
            console.log('Message sent to the new window');
        }
    });
}

3. 完善权限配置 #

确保manifest.json中包含必要的主机权限，否则无法向https://localhost/index.html注入脚本：

{
  "manifest_version": 3,
  "permissions": ["tabs", "scripting", "storage"],
  "host_permissions": ["https://localhost/*"]
}

内容的提问来源于stack exchange，提问作者N Ahmed