bdy tests capture

View as Markdown

$bdy tests capture [options]

Create a visual test session from an explicit URL list, a URLs file, or a sitemap

OPTIONS

--urls <urls>

URLs to compare (comma-separated list, e.g.,

--sitemap <sitemap>

URL of a sitemap to fetch URLs from (e.g.,

--sitemap

"https://example.com/sitemap.xml")

--urlsFile <urlsFile>

File with URLs to compare (e.g., --urlsFile "urls.txt")

--dryRun

Print the URL list without sending it to Buddy

--follow

Follow same-origin links and capture all reachable pages (default: false)

--respectRobots

Respect robots.txt (default: false)

--ignoreUrls <ignoreUrls...>

Ignore URLs whose full URL matches the regex (e.g., --ignoreUrls "https://example.com/admin/.*")

--ignore <ignores...>

Ignore elements matching selectors while comparing (format: [scope::]type=value, e.g.,

--ignore

"CSS=.ad-banner" "XPATH=//div[@id='popup']" "example.com::CSS=.cookie-notice")

--cookie <cookies...>

Set cookies used when visiting the URLs (format: [scope::]cookie_value, e.g., --cookie "session=abc123" "example.com::auth=token123; Path=/; Secure; HttpOnly")

--header <headers...>

Set HTTP headers used when visiting the URLs (format: [scope::]name=value, e.g., --header "Authorization=Bearer token" "example.com::Accept=application/json")

--delay <delays...>

Add delay in milliseconds before taking screenshot (1-60000, format: [scope::]milliseconds, e.g., --delay "1000" "example.com::2000")

--waitFor <waitFors...>

Wait for elements to appear before taking screenshot (format: [scope::]type=value, e.g.,

--waitFor

"CSS=#content" "example.com::XPATH=//div[@class='loaded']")

-h, --help

display help for command

Documentation for bdy v1.22.49

Last modified on May 19, 2026

upload link

Examples

## capture an explicit list of urls
bdy tests capture --urls "https://example.com,https://example.com/about"$

## capture from a sitemap and follow links
bdy tests capture --sitemap https://example.com/sitemap.xml --follow$

## capture from a urls file and ignore a globbed selector
bdy tests capture --urlsFile ./urls.txt --ignore "header>.banner"$