How to Find Elements by XPath in Puppeteer?

Using Puppeteer, you can easily find elements with XPath instead of CSS selectors by utilizing the page.$x() function. This is particularly useful for navigating complex HTML structures. Here’s a more detailed and efficient way to use XPath with Puppeteer.

The following script demonstrates how to use Puppeteer to find elements by XPath and interact with them:

      const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({ headless: false });
  const page = await browser.newPage();

  // Open Bright Data's website
  await page.goto('');

  // Find the first h2 element using XPath
  const [firstH2] = await page.$x('//h2');
  if (firstH2) {
    const h2Text = await page.evaluate(el => el.textContent, firstH2);
    console.log('First H2 Text:', h2Text);
  } else {
    console.log('No H2 element found');

  // Find all anchor elements with a specific class using XPath
  const allLinks = await page.$x('//a[@class="specific-class"]');
  const linkTexts = await Promise.all( => page.evaluate(el => el.textContent, link))
  console.log('All Links with specific class:', linkTexts);

  // Close the browser
  await browser.close();



  1. Launching the Browser:
    • The script launches a Puppeteer browser in non-headless mode, allowing you to see the browser actions in real-time.
  2. Navigating to the Website:
    • The script navigates to Bright Data’s website using page.goto().
  3. Finding Elements by XPath:
    • First H2 Element: The script finds the first h2 element using page.$x('//h2'). It then extracts and logs its text content.
    • All Anchor Elements with a Specific Class: The script finds all anchor (<a>) elements with a class of specific-class using page.$x('//a[@class="specific-class"]'). It extracts and logs their text content.
  4. Closing the Browser:
    • Finally, the script closes the browser using browser.close().

For more detailed information on using XPath to select elements by class, check out this helpful guide.

This method ensures you can effectively navigate and interact with elements in complex HTML structures using XPath in Puppeteer, enhancing your web scraping and automation capabilities.

Ready to get started?