Selenium中JavascriptExecutor在Chrome正常，Firefox报sigmaInstance未定义

这种情况我之前也碰到过，Chrome正常但Firefox出问题，大概率是执行时机或者浏览器驱动的环境差异导致的，下面给你几个排查方向：

1. 页面脚本的加载等待不充分 #

Chrome和Firefox的页面渲染、脚本执行速度存在差异，虽然你觉得页面已经加载完成，但Firefox里sigma.js的初始化可能还没完成，导致全局的sigmaInstance还没挂载到window对象上。

解决方法：

• 不要在driver.get(url)之后直接执行JS，而是添加显式等待，直到sigmaInstance在全局上下文中存在：

  WebDriverWait wait = new WebDriverWait(driver, 10);
  wait.until(new ExpectedCondition<Boolean>() {
      public Boolean apply(WebDriver d) {
          return (Boolean) ((JavascriptExecutor) d).executeScript("return typeof sigmaInstance !== 'undefined'");
      }
  });
  // 确认存在后再获取实例
  Object sigmaInstance = ((JavascriptExecutor) driver).executeScript("return sigmaInstance");
  

• 也可以先等待sigma.js关联的DOM元素加载完成，再执行获取实例的操作。

2. FirefoxDriver的执行上下文异常 #

有时候FirefoxDriver可能意外切换到了iframe上下文，但你手动操作时是在主页面，这就会导致找不到全局的sigmaInstance（概率较低，但可以排查）。

解决方法：

• 先切换回主页面上下文再执行JS：

  driver.switchTo().defaultContent();
  Object sigmaInstance = ((JavascriptExecutor) driver).executeScript("return sigmaInstance");
  

3. Geckodriver与Firefox版本不兼容 #

Geckodriver（Firefox的驱动程序）对版本匹配要求很严格，如果版本不兼容，可能会导致JS执行环境出现奇怪的问题，比如无法访问全局变量。

解决方法：

• 核对你的Firefox版本与Geckodriver版本的兼容性，比如Firefox 115+需要Geckodriver 0.33.0及以上版本，更新到匹配的驱动版本即可。

4. Firefox的隐私设置干扰 #

Firefox默认启用的增强跟踪保护等设置，可能会阻止sigma.js的部分脚本执行，导致sigmaInstance无法正常初始化。而你手动操作时可能已经关闭了这些设置，但Selenium启动的是全新的Firefox实例，默认保留了这些限制。

解决方法：

• 配置FirefoxOptions关闭相关限制：

  FirefoxOptions options = new FirefoxOptions();
  // 关闭全局增强跟踪保护
  options.addPreference("privacy.trackingprotection.enabled", false);
  // 或者针对测试站点单独关闭
  options.addPreference("privacy.trackingprotection.origin_override", "{\"your-test-site.com\": false}");
  WebDriver driver = new FirefoxDriver(options);
  

5. Sigma.js的模块加载差异 #

如果sigmaInstance是通过ES模块异步加载的，Chrome和Firefox对模块全局暴露的处理可能有细微差异——手动在控制台能拿到是因为控制台在模块加载完成后执行，但Selenium的JS执行时机更早，此时实例还未挂载。

解决方法：

• 可以注入一个轮询监听函数，等待实例初始化完成：

  // 注入监听逻辑
  ((JavascriptExecutor) driver).executeScript("window.waitForSigma = setInterval(() => { if (typeof sigmaInstance !== 'undefined') { clearInterval(window.waitForSigma); window.sigmaReady = true; } }, 500);");
  // 等待实例就绪
  wait.until(d -> (Boolean) ((JavascriptExecutor) d).executeScript("return window.sigmaReady === true"));
  Object sigmaInstance = ((JavascriptExecutor) driver).executeScript("return sigmaInstance");
  

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