Table of contents
Scraping & asserting on page elements
On this page
Any standard Node.js script that successfully finishes an execution is a valid, passing browser check. However, in many cases you want to validate whether the session is actually showing the right stuff to the user.
This is a two-step process:
- Scrape the relevant item from the current page.
- Assert that it shows what you expect.
Both Playwright and Puppeteer offer many ways to scrape elements like buttons, forms or any arbitrary HTML element. We’ve listed the most used ones below, together with some tips on how to use them effectively.
Scraping text values
Both libraries provide the page.$eval() method which is a very powerful way to actually run a selector query inside a web page. See the example
below. Note: we are using Jest’s expect library for assertions here.
const playwright = require('playwright')
const expect = require('expect')
const browser = await playwright.chromium.launch()
const page = await browser.newPage()
await page.goto('https://news.ycombinator.com/news')
const name = await page.$eval('.hnname > a', el => el.textContent.trim())
expect(name).toEqual('Hacker News')
await browser.close()
const puppeteer = require('puppeteer')
const expect = require('expect')
const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto('https://news.ycombinator.com/news')
const name = await page.$eval('.hnname > a', el => el.textContent.trim())
expect(name).toEqual('Hacker News')
await browser.close()
- We require all needed modules and load a page.
- We use
$page.eval()and pass it two arguments: 1) a query selector string 2) a callback to handle the resulting element. - We inspect the element’s
textContentproperty and use thetrim()method to get rid of any trailing white space. - We validate that indeed the name is as expected.
Some may want to use the
innerTextproperty here, buttextContentis actually better
Scraping a list of values
Using the page.$$() (notice the two dollar signs) we can scrape an array of elements in one go. You commonly use this
when the query selector you are providing targets multiple similar elements on a page, say a list of links:
const playwright = require('playwright')
const expect = require('expect')
const browser = await playwright.chromium.launch()
const page = await browser.newPage()
await page.goto('https://news.ycombinator.com/news')
const stories = await page.$$eval('a.storylink', links =>
links.map(link => link.textContent).slice(0, 10)
)
expect(stories).toHaveLength(10)
expect(typeof stories[0]).toBe('string')
await browser.close()
const puppeteer = require('puppeteer')
const expect = require('expect')
const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto('https://news.ycombinator.com/news')
const stories = await page.$$eval('a.storylink', links =>
links.map(link => link.textContent).slice(0, 10)
)
expect(stories).toHaveLength(10)
expect(typeof stories[0]).toBe('string')
await browser.close()
- We select all
<a>elements that have the CSS classstorylink. - We pass these into the callback and use the
map()method to return just the link text. - We slice of the first 10 items.
Scraping form input elements
Text input fields
Use the .value property to get the text from a standard text input field.
const playwright = require('playwright')
const expect = require('expect')
const browser = await playwright.chromium.launch()
const page = await browser.newPage()
await page.goto('https://duckduckgo.com/', { waitUntil: 'networkidle' })
await page.type('#search_form_input_homepage', 'Playwright')
const searchValue = await page.$eval('#search_form_input_homepage', el => el.value)
expect(searchValue).toEqual('Playwright')
await browser.close()
const puppeteer = require('puppeteer')
const expect = require('expect')
const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto('https://duckduckgo.com/', { waitUntil: 'networkidle2' })
await page.type('#search_form_input_homepage', 'Puppeteer')
const searchValue = await page.$eval('#search_form_input_homepage', el => el.value)
expect(searchValue).toEqual('Puppeteer')
await browser.close()
Checkboxes, radio buttons and dropdown selects
Scraping the values of other common form elements is pretty similar to scraping text inputs, with a few quirks here and there.
const playwright = require('playwright')
const browser = await playwright.chromium.launch()
const page = await browser.newPage()
await page.setViewportSize({ width: 1280, height: 1800 })
await page.goto('https://getbootstrap.com/docs/4.3/components/forms/#checkboxes-and-radios')
// Checkboxes
const checkboxStatus = await page.$eval('#defaultCheck1', input => input.checked)
console.log('Checkbox checked status:', checkboxStatus)
// Radio buttons
const radios = await page.$$eval('input[name="exampleRadios"]', inputs => inputs.map(input => input.value))
console.log('Radio values:', radios)
await page.goto('https://getbootstrap.com/docs/4.3/components/forms/#select-menu')
// Dropdown selects
const selectOptions = await page.$$eval('.bd-example > select.custom-select.custom-select-lg.mb-3 > option', options => options.map(option => option.value))
console.log('Select options are:', selectOptions)
await browser.close()
const puppeteer = require('puppeteer')
const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.setViewport({ width: 1280, height: 1800 })
await page.goto('https://getbootstrap.com/docs/4.3/components/forms/#checkboxes-and-radios')
// Checkboxes
const checkboxStatus = await page.$eval('#defaultCheck1', input => input.checked)
console.log('Checkbox checked status:', checkboxStatus)
// Radio buttons
const radios = await page.$$eval('input[name="exampleRadios"]', inputs => inputs.map(input => input.value))
console.log('Radio values:', radios)
await page.goto('https://getbootstrap.com/docs/4.3/components/forms/#select-menu')
// Dropdown selects
const selectOptions = await page.$$eval('.bd-example > select.custom-select.custom-select-lg.mb-3 > option', options => options.map(option => option.value))
console.log('Select options are:', selectOptions)
await browser.close()
Key takeaways are:
- Checkboxes are mostly singular items, use the
page.$eval()method. - Radio buttons come in groups, use the
page.$$eval()method and.map()over result. - For selects, you are probably interested in the nested
optionelements, not so much the parentselectelement. Use thepage.$$eval()method.
Built-in shortcuts
Both libraries offer some built-in shortcuts to access common elements of a typical webpage which you can use in Checkly. For the full details see the Playwright docs or the Puppeteer docs.
...
await page.goto('https://www.google.com/')
// grabs the page title
const title = await page.title()
// grabs the page's URL
const url = await page.url()
// return an object with the page's viewport setting
const viewport = await page.viewportSize()
console.log('Page width is:', viewport.width)
...
await page.goto('https://www.google.com/')
// grabs the page title
const title = await page.title()
// grabs the page's URL
const url = await page.url()
// return an object with the page's viewport setting
const viewport = await page.viewport()
console.log('Page width is:', viewport.width)
More resources
Quickstart
You can contribute to this documentation by editing this page on Github