Chrome扩展Manifest V3下隐身窗口无法设置Cookie问题

问题原因 #

Spanning模式下，扩展在普通窗口和隐身窗口共享进程，但Chrome为隐身窗口维护了独立的Cookie存储。默认调用chrome.cookies.set会操作普通窗口的Cookie存储，因此无法在隐身窗口生效。

解决方案 #

设置Cookie时需指定隐身窗口对应的Cookie Store ID，步骤如下：

1. 获取隐身窗口的Cookie Store ID
   通过chrome.cookies.getAllCookieStores获取所有Cookie存储，筛选出标记为incognito的存储项。

2. 调用chrome.cookies.set时添加storeId参数
   将获取到的隐身窗口Store ID传入设置参数中，确保Cookie写入到隐身窗口的独立存储。

修改后的代码示例 #

// 获取所有Cookie存储，找到隐身窗口对应的Store ID
chrome.cookies.getAllCookieStores((stores) => {
  const incognitoStore = stores.find(store => store.incognito);
  if (!incognitoStore) {
    console.error("未找到隐身窗口的Cookie存储");
    return;
  }

  // 设置Cookie时指定storeId
  chrome.cookies.set(
    {
      name: 'test_cookie',
      value: JSON.stringify({name: 'some-test'}),
      secure: true,
      sameSite: 'no_restriction',
      url,
      path: '/',
      domain: getCookieDomain(new URL(url).hostname),
      expirationDate: Math.floor(new Date(new Date().getTime() + 1.86e6).getTime() / 1000),
      storeId: incognitoStore.id // 关键：指定隐身窗口的Cookie存储ID
    },
    (cookie) => {
      console.log("Cookie设置结果:", cookie);
      // 捕获可能的错误
      if (chrome.runtime.lastError) {
        console.error("设置Cookie失败:", chrome.runtime.lastError.message);
      }
    }
  );
});

额外检查项 #

• 确保manifest.json中已声明cookies权限，以及目标域名的主机权限（如<all_urls>或具体域名）：

  {
    "permissions": ["cookies", "<all_urls>"]
  }
  

• 验证getCookieDomain函数返回的域名格式正确（如.example.com），避免因域名不匹配导致设置失败。
• 确认url为HTTPS协议（因为secure: true要求Cookie仅在HTTPS环境下设置）。

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