feat(plugins): sitemap plugin collecting visited pages

[DavertMik]

Adds a sitemap plugin that collects all pages visited while tests run and saves them as output/sitemap.xml (sitemap protocol).

plugins: {
  sitemap: { enabled: true }
}

or npx codeceptjs run -p sitemap

How it works

Listeners are attached once per browser instance on test.started. Nothing is added to test steps:

• Playwright: browser.on('context') → context.on('page'), so contexts created later by session() are covered. Each page records its URL on load, and on main-frame framenavigated for history.pushState routes.
• Puppeteer: browser.on('targetcreated') attaches the same load and framenavigated listeners to every new page.
• WebDriver: subscribes to the BiDi events browsingContext.load, historyUpdated and contextCreated once per session, and filters out iframe contexts. Without BiDi nothing is collected, and a debug message says so.
• Fragments are dropped, and non-http(s) URLs are skipped.
• run-workers: each worker writes its URLs to a temporary file, and the main process merges them into one sitemap.
• Pages visited in a Before hook on a freshly started browser are recorded only from the first test onward.

Options: outputName (default sitemap.xml), output (directory), stripQuery (default false).

Testing

• test/unit/plugin/sitemap_test.js: 8 tests covering dedup, SPA routes and iframe filtering, Puppeteer tabs opened later, Playwright contexts created later, WebDriver BiDi events, stripQuery, the worker merge, and the empty run.
• Playwright session_test.js: pages opened only inside session() contexts are recorded.
• Ran the Playwright acceptance within tests locally, both in a single process and with run-workers 2. Both runs passed and wrote the same 7-page sitemap.
• Ran the Puppeteer acceptance within tests: same sitemap. One @Playwright-only test fails both with and without the plugin.
• WebDriver was only tested with mocked BiDi events. No Selenium was available locally.

🤖 Generated with Claude Code