如何在 Puppeteer 中调试？

使用 Puppeteer 时，有效的调试对于确保顺利实现浏览器自动化和网页抓取至关重要。以下是调试 Puppeteer 脚本的一些技巧和最佳实践。

1.利用 `console.log()` 获取见解

使用 console.log() 是在 Puppeteer 脚本执行时追踪变量和元素等数值的直接方法，有助于您发现问题。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  // Log the page title
  const title = await page.title();
  console.log('Page title:', title);

  await browser.close();
})();

2.启用详细的日志记录

激活详细日志记录可提供脚本执行相关的详细信息，以便更轻松地排除故障。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    args: ['--enable-logging', '--v=1'],
  });
  const page = await browser.newPage();
  await page.goto('https://example.com');

  await browser.close();
})();

3.实现 Try-Catch 块

使用 try-catch 块有助于妥善地管理错误，确保脚本不会意外崩溃。

      const puppeteer = require('puppeteer');

(async () => {
  try {
    const browser = await puppeteer.launch();
    const page = await browser.newPage();
    await page.goto('https://example.com');
    // Additional actions
    await browser.close();
  } catch (error) {
    console.error('Error occurred:', error);
  }
})();

4.确认环境设置

确保您的环境已正确配置必要的依赖项，例如最新版 Node.js 和 Puppeteer。npm list puppeteer

5.使用 `page.waitForSelector()` 进行同步

使用 page.waitForSelector() 而非 setTimeout() 来等待元素加载，从而提高脚本的可靠性。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  await page.waitForSelector('#element-id');
  await page.click('#element-id');

  await browser.close();
})();

6.监控网络请求

使用 page.on('requestfailed') 监控失败的请求，从而有效处理网络错误。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();

  page.on('requestfailed', request => {
    console.error('Request failed:', request.url(), request.failure().errorText);
  });

  await page.goto('https://example.com');
  await browser.close();
})();

7.验证页面状态

定期检查页面状态，确保页面符合您的期望，然后再执行进一步的操作。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  const url = await page.url();
  if (url !== 'https://example.com') {
    console.error('Incorrect page navigated');
  }

  await browser.close();
})();

8.禁用沙盒以便兼容

禁用沙盒有助于解决特定环境中的问题，例如在容器中运行 Puppeteer 时。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({ args: ['--no-sandbox'] });
  const page = await browser.newPage();
  await page.goto('https://example.com');

  await browser.close();
})();

9.模拟不同的设备

模拟各种设备和屏幕尺寸有助于发现设计和响应能力方面的问题。

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.emulate(puppeteer.devices['iPhone X']);
  await page.goto('https://example.com');

  await browser.close();
})();

10.使用清晰的错误消息

提供详细的错误消息有助于快速、精确地查明 Puppeteer 脚本中问题的根本原因。

      const puppeteer = require('puppeteer');

(async () => {
  try {
    const browser = await puppeteer.launch();
    const page = await browser.newPage();
    await page.goto('https://example.com');
  } catch (error) {
    console.error('An error occurred while navigating to the page:', error);
  }
})();

按照这些调试技巧，您可以有效地发现并解决 Puppeteer 脚本中的问题，确保可靠的浏览器自动化和网页抓取。

开始免费试用

获得全球超20000 位客户的信赖