如何解决Jenkins代理上WebDriverIO测试VSCode扩展的‘element not interactable’错误

AI 小北

2026-6-30

解决WebDriverIO VSCode扩展测试在Jenkins代理（Alma OS9）上的「element not interactable」错误

排查与修复步骤

1. 修正窗口状态与渲染等待逻辑

Jenkins代理多为无头运行，窗口尺寸不足或元素未完全渲染是常见诱因：

测试初始化时强制设置足够的窗口大小：
```
await browser.setWindowSize(1920, 1080);
```

添加显式等待确保VSCode页面完全加载：

await browser.waitUntil(async () => {
  return await browser.execute(() => document.readyState === 'complete');
}, { timeout: 10000 });

2. 优化InputBox操作的时序与方式

element not interactable往往是元素未就绪就执行操作导致，调整selectQuickPick前的步骤：

替换InputBox.clear()为更可靠的手动清空逻辑：

const inputBox = await browser.$('input[aria-label="Input"]');
await inputBox.waitForDisplayed({ timeout: 5000 });
await inputBox.click();
await browser.keys(['Control', 'a']);
await browser.keys('Delete');

等待候选列表渲染完成后再调用selectQuickPick：

await browser.waitUntil(async () => {
  const quickPickItems = await browser.$$('.quick-input-list-item');
  return quickPickItems.length > 0;
}, { timeout: 8000 });
await inputBox.selectQuickPick("Item One");

3. 对齐代理与本地的环境配置

验证代理上Node.js版本为16.x（与本地一致）：
```
node --version
```
检查VSCode版本是否为1.85，避免版本差异导致DOM结构变化：
```
code --version
```
重新安装依赖确保完整性：
```
npm ci
```

4. 适配无头运行的特殊配置

Alma OS9的无头环境可能存在显示驱动限制：

启动VSCode时添加沙箱禁用参数：

const vscode = await browser.newBrowser({
  browserName: 'vscode',
  capabilities: {
    'vscode:options': {
      args: ['--no-sandbox', '--disable-dev-shm-usage']
    }
  }
});