Test an extension

View as Markdown

Provide the path to an unpacked extension, and your coding agent loads it when the browser starts.

/shiplight verify my Chrome extension at ./my-extension works —
open https://example.com and check that the extension
injected its UI into the page.

Your agent starts Chromium in headed mode with the extension loaded. It can inspect and interact with content scripts, banners, sidebars, and other changes the extension makes to the DOM.

Use a persistent Chrome profile when you need to test the extension in an authenticated session:

/shiplight verify my extension at ./my-extension works on the dashboard —
use the Chrome profile at ./my-chrome-profile and open
https://app.example.com/dashboard

Review the evidence

You receive screenshots and a summary of the extension's effects on the page. Screenshots capture page content but not the browser toolbar. Verify the extension through its changes to the DOM, console output, network requests, or storage state rather than through its toolbar icon.

Use the extension in YAML tests

Generated YAML does not automatically retain the extension used during an interactive session. To load the extension when the test runs, add extensionDir to the test's use: block. See Chrome Extension Testing in the Fixtures reference.