crxbox

Appearance

Changelog ​

All notable changes to crxbox are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2026-06-08 ​

First stable release. No API changes since 0.2.1 — this declares the public surface SemVer-stable: ext (id/url/openPage/acceptDialogs/dragAndDrop/contentUi/ simulateUpdate), ext.popup (open/openForTab/openInWindow), ext.background, ext.storage, ext.windows, ext.tabs, the storage matchers, and the CrxboxError diagnostic codes. Breaking changes from here require a major bump.

Across 0.0.0 → 1.0.0 crxbox closed every reported adoption blocker and both hard testability boundaries (current-window capture, update-gated migration). simulateUpdate remains @experimental (relies on a version-sensitive Chromium internal).

Changed ​

  • Packaging: the published tarball now includes CHANGELOG.md.

Notes ​

  • Network-dependent flows (OAuth, cloud/Drive sync) are out of scope by design — stub them with Playwright's page.route(...).

[0.2.1] - 2026-06-08 ​

Fixed ​

  • ext.windows.create({ tabs }) / ext.tabs.create() no longer hang on data: (or blob:) seed URLs. toUrl previously required :// and mangled schemeless-absolute URLs into chrome-extension://<id>/<url>, which made tab capture time out. Any scheme: URL now passes through untouched; only truly bare paths resolve against the extension origin.

[0.2.0] - 2026-06-08 ​

Added ​

  • ext.popup.openInWindow(window, popupPath?, opts?) — open the popup as a tab inside a seeded window so its chrome.tabs.query({currentWindow:true}) resolves to that window; the headless-friendly way to test "save the current window's tabs" / active-window flows.
  • Diagnostic tabs/create-failed — ext.tabs.create now raises a structured error instead of a silent timeout / generic eval failure.

Changed ​

  • ext.popup.openForTab focuses the window containing activeTab (deterministic) and is documented as headed-only for real-toolbar-popup fidelity; use openInWindow in headless.

[0.1.0] - 2026-06-08 ​

Added ​

  • ext.windows.create() and ext.tabs (create/query/close) — seed a real browser window with known tabs and drive active-tab / "save current window" flows.
  • Storage matchers: toEventuallyHaveStorageValue (polling) and toHaveStorageKeys (subset).
  • ext.simulateUpdate() (experimental) — fire chrome.runtime.onInstalled to exercise migration logic.
  • ext.openPage(), ext.acceptDialogs(), ext.dragAndDrop().
  • Opt-in popup viewport: popup.open(path, { viewport }) + fixture popupViewport.
  • Launch-config forwarding: headless/--headed/PWDEBUG/channel/slowMo/use.launchOptions.
  • Diagnostics: loader/duplicate-playwright, drag/no-bounding-box, drag/cross-page, window/create-failed, tabs/not-found, simulate-update/unavailable.
  • docs/fixture-extension.md — first-party example-extension reference; README debugging recipe.

Changed ​

  • popup.open() / openForTab() default to the manifest's action.default_popup.
  • openForTab is marked @experimental and retries the focus/openPopup sequence once.

Notes ​

  • Pre-1.0: the API may still change. Consume as a published or npm packed tarball sharing the consumer's single @playwright/test instance (not a live dev-checkout symlink).