Figma插件开发中用js-cookie获取网站Cookie出现报错该如何解决

js-cookie的运行完全依赖浏览器原生document.cookie API，但Figma插件采用双层沙箱隔离架构，根本不满足这个库的运行前提：

• 插件的核心逻辑执行层运行在隔离Web Worker环境，没有暴露完整的DOM对象，连document本身都是未定义状态
• 插件的UI层是嵌入在Figma主站域名下的跨源iframe，和你想要读取Cookie的目标网站天然存在跨域隔离
  直接引入js-cookie在插件代码中运行，必然触发Cannot read properties of undefined (reading 'cookie')这类初始化报错，也就是截图中显示的异常。

• 先校验当前运行环境的API可用性
  在插件入口位置插入测试代码：
  console.log('document类型:', typeof document, 'cookie属性存在性:', typeof document?.cookie)
  只要输出显示document为undefined、或cookie属性不可读取，就说明js-cookie没有可运行的基础，直接移除对该库的依赖即可排除初始化报错。
• 按场景调整Cookie获取的实现方案
  Figma沙箱环境本身没有权限直接跨站读取任意网站的Cookie，所有方案必须符合浏览器跨域安全规则：
  • 如果需要读取Figma自身域名下的Cookie：将读取逻辑放到插件UI的iframe上下文（也就是和plugin.html直接绑定的前端代码中，不要放到Worker逻辑层），如果是基于Chromium内核的Figma桌面端，可以申请浏览器扩展级别的chrome.cookies权限读取，不要用js-cookie做跨iframe的Cookie读写。
  • 如果需要读取外部指定网站的Cookie：完全无法在插件运行时直接拉取，要么引导用户手动粘贴对应Cookie值作为输入，要么通过配套的本地用户侧代理服务中转读取，沙箱环境会直接拦截所有跨域的第三方Cookie请求。
• 替换js-cookie的冗余依赖
  js-cookie本身只是对document.cookie的轻量封装，在插件同域UI层确实需要读写Cookie的场景，直接手写几行原生解析逻辑即可，不需要引入第三方库额外增加运行时错误概率。

• 绝对不要把Cookie读取逻辑写到Figma插件的主逻辑线程（也就是可以直接访问Figma文档编辑API、在打开插件时最先执行的那部分代码）中，这个线程是纯Worker沙箱，连全局window对象都不存在，引入js-cookie会直接触发模块加载异常。
• 不要试图通过嵌套第三方网站iframe的方式读取Cookie，Figma的内容安全策略（CSP）会直接拦截所有跨域iframe加载，就算加载成功，跨源iframe也受浏览器同源策略限制，完全无权读取目标站点的Cookie内容。

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