Puppeteer无法定位密码字段元素：Selector在DevTools有效却报错

以下是针对问题的几种排查和解决方法：

• 等待元素完全渲染
  点击登录按钮后，密码页面可能还在加载或动态渲染，直接执行focus会找不到元素。先通过waitForSelector等待元素出现，再进行操作：

await signinBtn.click();
// 等待密码字段元素加载，设置10秒超时避免无限等待
await page.waitForSelector('[data-testid="currentPasswordInput"]', { timeout: 10000 });
await page.focus('[data-testid="currentPasswordInput"]');
await page.keyboard.type('your-password');

• 检查是否嵌套在iframe中
  如果密码字段位于iframe内部，Puppeteer默认无法直接访问iframe内的元素，需要先切换到对应iframe：

await signinBtn.click();
// 等待iframe加载，替换为实际的iframe选择器
const iframe = await page.waitForSelector('iframe[src*="password"]');
const frame = await iframe.contentFrame();
// 在iframe内等待并操作元素
await frame.waitForSelector('[data-testid="currentPasswordInput"]');
await frame.focus('[data-testid="currentPasswordInput"]');

• 修正选择器转义问题
  代码中的"是HTML实体转义，换成实际的双引号（注意用单引号包裹选择器字符串）：

// 直接使用正确的选择器格式
await page.waitForSelector('[data-testid="currentPasswordInput"]');

• 等待页面跳转完成
  点击登录按钮可能触发页面跳转，需等待页面导航完成后再操作：

await signinBtn.click();
// 等待页面加载完成（networkidle2表示网络请求基本停止）
await page.waitForNavigation({ waitUntil: 'networkidle2' });
// 再定位密码字段
await page.waitForSelector('[data-testid="currentPasswordInput"]');
await page.focus('[data-testid="currentPasswordInput"]');

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