IME 自动化测试开源方案

IME 自动化测试方案总结

现状：IME 测试自动化是个业界难题

核心困难在于：浏览器自动化工具（Playwright/Puppeteer）运行在浏览器外部，而 IME 是操作系统级别的服务。自动化工具无法直接调用操作系统的输入法，因为：

1. Headless 模式下没有操作系统 IME 可用
2. 即使有 GUI 环境，程序化控制 IME 候选词选择非常困难
3. CDP（Chrome DevTools Protocol）只提供了 Input.insertText，直接跳过组合过程

现有开源方案

对于项目，推荐两种自动化策略

策略1：事件注入测试（轻量，不需要真实 IME） 用 Playwright + 手动构造 CompositionEvent 来模拟 IME 行为。虽然不是真实 IME，但能验证你的代码是否正确处理了 isComposing、compositionstart、compositionend 事件：

// Playwright 测试：模拟 IME 组合过程
test('IME composition should not trigger router.push', async ({ page }) => {
  await page.goto('http://localhost:3000/blog');
  const input = page.locator('input[placeholder*="搜索"]');
  
  // 模拟 compositionstart
  await input.evaluate(el => {
    el.dispatchEvent(new CompositionEvent('compositionstart', { bubbles: true }));
  });
  
  // 模拟组合中输入（isComposing = true）
  await input.fill('a');  // 拼音
  // 验证 URL 没有变化（router.push 不应触发）
  expect(page.url()).not.toContain('search=');
  
  // 模拟 compositionend
  await input.evaluate(el => {
    el.dispatchEvent(new CompositionEvent('compositionend', { 
      bubbles: true, 
      data: '啊' 
    }));
  });
  
  // 验证 URL 在组合结束后才更新
  await page.waitForURL(/search=/);
});

策略2：Adobe IMPACT（重量级，需要 GUI 环境） 如果你需要测试真实 IME 的完整行为（包括候选词窗口、多步选择等），IMPACT 是目前最专业的方案。但它需要：

• Windows/macOS GUI 环境（不能 headless）

• 安装对应语言的系统 IME

• Python + Selenium 环境

 

对于个人网站，策略1（事件注入）就够了。原因：

1. 你要测的不是"IME 本身是否正常"，而是"你的代码是否正确处理了 IME 事件"
2. 事件注入测试可以在 CI 中 headless 运行
3. 成本低，维护简单 需要我帮你写一套 Playwright IME 测试用例吗？ Sources:

• Adobe IMPACT - IME Automation for CJK

• puppeteer-text-typer

• Puppeteer Feature Request: Composition Events

• Playwright keyboard.insertText 文档