1.x is a statement-by-statement port of Playwright's JavaScript client. It needs Elixir 1.18 or
later (CI tests down to OTP 27). Its major.minor is Playwright's and the patch is ours: depend on
~> 1.65.0.
The format is based on Keep a Changelog.
The JS-client port
The client ports the official JS client at a pinned driver version, and its public API is
generated from Playwright's docs, so playwright.dev
applies: page.getByRole(...) is Playwright.Page.get_by_role/3. Calls take the arguments and
options upstream does, with a tuple form ({:ok, _} | {:error, e}) and a bang form; waits JS
starts without await return a Playwright.Promise.
The rename to Playwright
The modules are Playwright.* and the app is :playwright; the Hex package stays
playwright_ex: {:playwright, "~> 1.65.0", hex: :playwright_ex}. hex: is required,
as playwright on Hex is another library.
Playwright.Test
use Playwright.Test brings Playwright Test's runner to ExUnit: pooled worker browsers
(Playwright.Test.BrowserPool), context defaults, traces, screenshots and videos, steps,
snapshot paths, soft assertions and timeouts. Playwright.Case gives each test a page. See
Testing with ExUnit.
Versioning
1.65.x drives Playwright 1.65; the patch counts our releases (our fixes and driver patch
bumps), and each release below names its exact driver. Our breaking changes ship only with an
upstream minor, so ~> 1.65.0 is safe.
Backwards-incompatible changes
1.x is a clean cut from 0.16: the guid-based modules, Selector, EventWaiter and the other
0.16 APIs are gone.
[Unreleased]
[1.65.0-rc.3] 2026-11-21
Drives Playwright 1.65.1, on Node 26.13.1. No upstream API changes.
Added
Playwright.Test.info/0insetup_all: the module'sfile,timeoutand resolveduseoptions (config, project, module).Playwright.Test.step/2,3andstep_skip/2,3insetup_all, astest.stepinbeforeAll: a step returns its body's value and raises its error (a boxed step's where its helper is called), unrecorded.Playwright.Test.parameters/1takesname:, upstream'sproject.name: a failed test prints the project as#Playwright.Test.Project<"Mobile Safari">, not the whole device, and the name is the snapshot templates'{projectName}.use Playwright.Testrecords eachassertandrefuteas anexpectstep of the test's trace, as upstream'sexpectis:Expect "assert", the expression as its subtitle, the right side of a comparison or match as itsexpected, a failed one with its error at the test's level. They are ExUnit's otherwise, but a function that ends in a failing assertion keeps its frame in the stacktrace. Helper modulesimport Playwright.Test.Assertions. Opt out withuse Playwright.Test, assert_steps: false, or the same key inconfig :playwright, :test.headlessandchannelare worker options ofPlaywright.Test(config, project, module,BrowserPool.browser/1), set overlaunch_options', as upstream's fixtures.
Changed
on/3,once/3,wait_for_eventand the other event functions take any string as an event, as JS's emitters do (one that never fires: a wait times out); atoms still raise for an unknown event.- RC only:
browser_nameandpreserve_outputalso take upstream's strings ("webkit","failures-only"); an unknown string raises with upstream's message. - What's ported answers "can I do X?": a summary, an overview of the features by goal (automating a browser, in tests or not; writing, configuring, running and debugging tests), then each feature's table of what is ported, partly or not, with the reason or the issue.
- RC only: Breaking:
use Playwright.Testreplaces ExUnit'sassertandrefutewithPlaywright.Test.Assertions', so a module that importsExUnit.Assertionsagain after theuse, or another library'sassert/2, no longer compiles (an ambiguousassert). Opt out withassert_steps: false, or importPlaywright.Test.Assertions, except: [...]beside it. - RC only:
Playwright.Test.GitHubFormatterannotates amix test --failedrerun too, as upstream'sgithubreporter annotates every attempt: a test passing there counts as flaky in the rerun's summary, and one failing again gets its error underRetry #1. Pass it to both. - RC only: Breaking:
config :playwright, Playwright.Test.GitHubFormatter, report_slow_tests: ...isconfig :playwright, :test, report_slow_tests: ..., as upstream's top-levelreportSlowTests, withfalsefor none (nilis the default there, as for every:testkey); other module keys ofconfig :playwrightraise. - RC only: Breaking: the
:testconfig's andBrowserPool.browser/1'sdriver:take onlyenv:;executable:,node:andcache_dir:areconfig :playwright, :driver's. - RC only: Breaking:
config :playwright, :expect's:to_have_screenshot,:to_match_aria_snapshotand:to_passtake the matchers' snake_case keys (max_diff_pixels:,timeout:,path_template:,children: :equal), not JS keys. - RC only: Breaking:
Playwright.Test.parameters/1returns one private key,:"playwright.project", holding aPlaywright.Test.Project(name,use), not a key per option. - RC only: Breaking:
Playwright.Driver.install_browsers/2raises on a failed install, asinstall/1does, instead of returning{:error, {:exit_status, n}}. - RC only: Breaking:
mix playwright.install --forcereinstalls the driver with every flag,--dry-run,--listand--helptoo. - RC only: Breaking: option and field errors name keys bare:
unknown option x, expected one of y, z(wasunknown option :x, expected one of :y, :z),for opt(wasfor :opt). Errors of the runner, the pool, the driver and the config read<Module.function/arity or config path>: <problem>, expected ..., naming keys and values the same way (config :playwright, :test: unknown key tracing, expected one of browser_name, ...,invalid value 0 for workers, expected a positive integer); a call outside its scope (BrowserPool.browser/1past its test, a context before the registration) raisesRuntimeError, bad inputArgumentError. - RC only: Breaking:
Playwright.Test.in_registered_test?/0is replaced byin_registered_scope?/0, true in a test orsetup_all;info/0hastest_pidonly in a test. - RC only: Breaking: option values are checked only where upstream's config loader
checks them (
preserve_output,workers,output_dir,report_slow_tests, a project'sname,:expect'supdate_snapshots,ignore_snapshotsand:to_have_screenshot'stype), plusbrowser_name,on_startand the keys (an unknown key raises, the object forms' too); others pass as given, as upstream's.trace,screenshotandvideotake notrue/false, an unknown mode records nothing, a keyword list without:modeis:off, and:retry_with_trace/:retry_with_videoare:on_first_retry.test_id_attribute: ""sets none, as upstream'sif (testIdAttribute). - RC only: Breaking: a duplicated key no longer raises: the later wins, as in JS's
spread, in
use Playwright.Test,Test.use/1,Test.parameters/1and the keyword lists they take (trace: [mode: :on, mode: :off]is off,connect_options), in the config's (driver,report_slow_tests,config :playwright, :expectand its matchers'), and in the options ofPlaywright.Supervisor.start_link/1andchild_spec/1,step/3,attach/2andsnapshot_path/2. - RC only: Breaking:
@describetag/@tag Test.use(...)withbrowser_name,default_browser_type(a device's),launch_optionsorconnect_optionsraises when the module compiles a test of thetestmacro under it, with upstream's "Cannot use({ ... }) in a describe group, because it forces a new worker" message ("in a test" for a@tag), where rc.2'sTest.use/1raised for the first three in any tag and dropped a device's browser.@moduletag Test.use(...)now takes them, as upstream's top-leveltest.use. A test's worker is its module's (itsuse, then its@moduletags, the later per option), so a test the check doesn't see (a doctest, a bareExUnit.Case.test) gets the module's too. - RC only: Breaking:
info/0,output_path/1,attach/2andsnapshot_path/2outside their scope raise upstream's "... can only be called while test is running";output_path/1takes path segments too and raises upstream's message for a path outside the output dir (aRuntimeError). - RC only: Breaking:
Playwright.Test.info/0'sclose_deadlineisdeadline(upstream'stestInfo._deadline(), when the test's contexts close); ExUnit's raw kill time is gone. - RC only: Breaking:
retryis 1 undermix test --failed, else 0, its dir always-retry1, no longer counted from earlier-retryNdirs. - RC only:
Playwright.Test.GitHubFormatterlabels a test by its project's name only, not by everyparameterize:value, and a slow file's annotation is[project] › file, as upstream's. - RC only:
__options__/1is out of HexDocs, as are the selector builders ofIsomorphic.LocatorUtils: both are markedlibrary_api: truein their docs metadata, internal but stable for libraries that build on them, changed only with a CHANGELOG note.
Fixed
- RC only:
add_cookies,storage_state:andset_storage_statecheck their keys against the protocol's: a snake_casehttp_only:raises instead of being dropped. Errors name the argument and list index (cookies[0].http_only). - RC only: a
multipartfile's keys are checked as other nested objects' are:mime_type:raises, where the client failed treating the map as a stream. - RC only:
mix playwright.installforwards a--toplaywright install(rc.2 raised on it). - RC only:
get_by_roleandto_have_rolespecs and docs take roles as strings too, also those Playwright'sAriaRolelacks ("mark"), as JS does; locator descriptions print those as strings, not atoms that raise. - RC only:
Route.fulfill,abortandcontinuein a route handler have the handler's call site in the trace, which a tail call such asfn r -> Route.abort!(r) enddoesn't keep (BEAM drops its frame). - RC only: a boxed
Playwright.Test.step ... dois located where its helper is called, as thefnform and upstream's are, not at its own line in the helper.
[1.65.0-rc.2] 2026-11-18
Drives Playwright 1.65.1, on Node 26.13.1. No upstream API changes.
Added
Playwright.Promise.all/1,race/1andany/1, as JS'sPromise.all,Promise.raceandPromise.any(withPlaywright.AggregateError).- A warning when the connection has waited 5 s for one listener or route handler, which stalls every page on it: it names the listener, shows where it waits and points to the fix (Concurrency).
use Playwright.Test(anduse Playwright.Case) takes the context options as options of their own, Playwright Test'stest.use({ locale: 'de-DE' }):use Playwright.Case, locale: "de-DE", over the config's per option, under the call's, for every context of the module, itssetup_all's included (#257). Any option a layer (config, project, moduleuse, tags) gives asnilresets it to the layer under (the project's, the config's or the default), as upstream'sundefined; a call's ownnilof a context option orconnect_optionsis passed as given.context_options:is upstream'scontextOptions, for the other options ofnew_context, under an option of its own, so flat keys are the upstream-shaped form (config :playwright, :test, locale: "de-DE"). The config takes both too (config :playwright, :test, base_url: "...").Playwright.Test.config().context_optionsholds only the bag, not the options of their own: a library that read options from it should read the test's resolved options withPlaywright.Test.info().use.Playwright.Test.use/1gives a describe block or a test its options, as Playwright Test'stest.usein atest.describe:@describetag Test.use(timezone_id: "Europe/Berlin"),@tag Test.use(trace: :on). They layer per option, over the module's.Playwright.Test.parameters/1is a project forparameterize:, Playwright Test'sprojects: [{ use }]: its options are over the config's and under the module's, for every context of the module's run.browser_name,launch_optionsandconnect_optionsare options ofuse Playwright.Testand ofTest.parameters/1, and the defaults of the module'sBrowserPool.browser/1calls. Without abrowser_name(in the config either), a device'sdefault_browser_typepicks the browser, as upstream'sbrowserNamedefaults todefaultBrowserType.Playwright.Caseputsbrowser_name, Playwright Test'sbrowserNamefixture, in the context ofsetup_alland the tests: the module's browser,:chromium,:firefoxor:webkit.action_timeoutandnavigation_timeoutare options ofuse Playwright.Test,Test.use/1andTest.parameters/1too.Playwright.device/1andPlaywright.devices/0, Playwright's device descriptors as static data (upstream'simport { devices }), so a device works at compile time, spread as upstream's...devices['iPhone 13']:use Playwright.Test, Playwright.device("iPhone 13"),@moduletag Test.use(Playwright.device("Pixel 7")),Test.parameters(Playwright.device("Pixel 7")). A device is a keyword list of options, so the config takes it as it is:config :playwright, :test, Playwright.device("Desktop Chrome"), and a later key overrides its option, as upstream's{ ...devices['iPhone 13'], viewport }:Playwright.device("iPhone 13") ++ [viewport: ...]. The driver'sPlaywright.devices/1remains, with maps.
Changed
- RC only: Breaking: the tags
trace,screenshotandvideono longer set the recording modes, anduse Playwright.Test, tags: falseis gone (an unknown option now): write@tag Test.use(trace: :on)for@tag trace: :on, likewise for@describetagand@moduletag. OnlyTest.use/1's keys are read, so tags named as options are yours. A leftover plain tag is ignored silently, with no error, no warning and no recording: search for them (rg "@(module|describe)?tag[ (\[][^(]*\b(trace|screenshot|video):") and write@tag Playwright.Test.use(trace: :on). - RC only: Breaking:
mix playwright.installforwards its args toplaywright installas they are, without--:mix playwright.install chromium --with-deps. A--now raises, naming that fix. - RC only: Breaking:
mix playwright.install --forcealso reinstalls the browsers, as it's forwarded toplaywright install. - RC only: Breaking:
mix playwright.install --no-browserswith other args than--forceraises. - RC only:
Expect.to_pass!/2returns the callback's value from the attempt that passed, which JS assigns to an outerlet. Breaking:Expect.to_pass/2returns{:ok, value}, not:ok. - RC only: Breaking: a context created in
setup_allbeforeuse Playwright.Testregistered the module (a case template's ownsetup_allwith theuseonly in itsusing, or asetup_allabove the module'suse) makes the module'ssetup_allraise, naming the fix, as such a context insetupalready does. So does aBrowserPool.browser/1call there, or insetupbefore the test's registration, as it would miss the module's worker options. - RC only: Breaking: contexts and request contexts created in a module's
setup_all(or a process with it in$callers) get the context defaults and the config'scontext_options(base_urltoo), as Playwright Test'sbeforeAlldoes (#257). A context gets the config'saction_timeoutandnavigation_timeout, a request contexttimeout:theaction_timeout(0for:infinity) and no navigation timeout: no limit by default, where they had the client's 30 s. - RC only: Breaking: a module's
setup_allcallbacks fail past ExUnit's timeout of the module (@moduletag timeout:, else ExUnit'stimeout), with"setup_all" hook timeout of 60000ms exceeded., as Playwright Test'sbeforeAllhook times out (#257). A longersetup_allneeds a@moduletag timeout:. A failedsetup_all's pooled browsers reset at the module's end, as a failed test's do. - RC only: Breaking:
use Playwright.Casealso aliasesPlaywright.KeyboardandPlaywright.Mouse, soKeyboardandMousein such a module resolve to Playwright's modules; alias your own module after theuse(alias MyApp.Keyboard) to keep it. - RC only: Breaking: an option of the config's
context_optionsgiven asnilfalls back to Playwright Test's default (locale: nilisen-US), as upstream'sundefined, not to the client's. - RC only: a handle of the wrong class (a
Locatorpassed toPage.get_by_test_id/2) fails in the facade function, whose clause matches its struct, not inPlaywright.Runtime.Heap.key/2. - RC only: a string that is not UTF-8 (
Route.fulfill!(route, body: png)) fails with a hint to pass bytes as{:binary, bytes}, not only "Message cannot be encoded as JSON". - RC only: a matcher's unknown
message:option points toExpect.message/2(JSexpect(x, message)), for the matcher as called. - RC only: an error a listener or route handler raises in a
Playwright.Testtest fails the test and stops it at once, as Playwright Test's worker does, where it failed only at the end of the body (a test hung on a dialog its failed:dialoglistener left open). The test's process exits with the error; later such errors are dropped. Unlike Playwright Test, its failure screenshots are taken at teardown, after itson_exitcallbacks, and such an error after the body ended is still only logged. A test that traps exits isn't stopped. - RC only: a failed test's "Trace of ..." hint prints after the run, below ExUnit's summary: above its own failure it read as the previous failure's.
Fixed
- RC only:
mix playwright.installandmix playwright.clifailed with "module :public_key is not available" when run before the project was compiled (e.g. right aftermix deps.getin CI).
[1.65.0-rc.1] 2026-11-16
Drives Playwright 1.65.0.
Changed
- Breaking: rewritten as a port of Playwright's JS client, its API generated from Playwright's
docs: structs in place of guids, locators in place of
Selector,on/3andexpect_*in place ofsubscribe/2andEventWaiter, exceptions named after the JS errors. - Breaking:
PlaywrightExis renamedPlaywrightand the app:playwright; the Hex package staysplaywright_ex, so the dependency needshex: :playwright_ex. Move every library that uses PlaywrightEx in the same bump. - Breaking: the client installs its pinned driver (Node and
playwright-core) on first start or withmix playwright.install, in place of the npmplaywrightpackage.executable:takes a Playwright 1.65 CLI. - Breaking: behaviour follows upstream: unknown options raise, nested maps use the JS keys
(
sameSite), JSnullis:null, tuple forms return{:error, e}only for Playwright's errors, failed bang matchers raisePlaywright.ExpectError, dialogs without a listener are dismissed. - Breaking: Playwright 1.65's own: actions wait for the element to be not inert, cookie matching follows RFC 6265, proxy credentials only answer proxy challenges, and text the browser doesn't render leaves accessible names and aria snapshots.
- Versions follow Playwright's: major.minor is Playwright's, the patch ours, so 0.16 is followed by 1.65.0.
- Licensed under Apache-2.0 (was MIT), as the port of Playwright's client; 0.16 and earlier stay MIT.
- No runtime dependencies:
nimble_options,mimeandwebsockexare gone.
Removed
- Breaking:
launch_browser/2,subscribe/2,send/2,EventWaiter,Selector,JsLogger, theconnection:option, the supervisor'stimeout:,js_logger:,ws_endpoint:(useBrowserType.connect/3) and:fail_on_unknown_opts, andTracing'scoverage:.
Added
- Playwright's whole client API, with a tuple and a bang form per call:
Playwright.Promisefor calls JS starts withoutawait(Promise.async/1),Playwright.RegExpfor JS regexes,AbortControllersignals, API requests,CDPSession,Clock,Credentialsand the rest. - User callbacks (route handlers, listeners, exposed functions, locator handlers) run with the
registering process's
$callers, so the Ecto sandbox, Mox andReq.Testfind the test. Playwright.Test: Playwright Test's runner for ExUnit, with pooled worker browsers (Playwright.Test.BrowserPool), context defaults, traces, screenshots and videos, steps, snapshot paths, soft assertions, timeouts andinfo/0.Playwright.Casegives each test apage;Playwright.Test.GitHubFormatteris thegithubreporter.Expect.to_pass/2,Expect.poll/3,Expect.soft/1andExpect.message/2, beside upstream's matchers.mix playwright.install(--no-browsersfor the driver only) andmix playwright.cli.__options__/1on the facade modules, for wrappers (its shape is unstable).usage-rules.mdships in the package:usage_rules: [:playwright].- Guides: getting started, from playwright.dev to Elixir, cheatsheet, testing with ExUnit, events and waiting, network, debugging and CI, concurrency.
0.16 and earlier
[0.16.0] 2026-11-04
Added
BrowserContext.credentials_install/2,credentials_create/3,credentials_get/2andcredentials_delete/3wrap Playwright's virtual WebAuthn authenticator (context.credentials).
[0.15.0] 2026-10-17
Added
Tracing.tracing_start/2acceptscoverage: trueto collect Istanbul coverage into the trace.- Virtual WebAuthn credentials round-trip
sign_countin storage state.
Changed
- Require Playwright 1.64 or newer. Older local drivers are rejected, and remote connections advertise 1.64. The bundled development dependency is 1.64.1.
Fixed
- Clear request interception after a timed-out installation, including queued requests.
- Skip route callbacks when a required subscription fails and release partial subscriptions.
[0.14.0] 2026-10-02
Added
- Page/context request routing with one driver-matched glob handler per target, page-first precedence, and linked callback failures.
Route.fulfill/2with binary, JSON, and local-file bodies, plusabort/2,continue/2, and removal that cancels active callbacks. Isolated error messages are available withon_error: :message.- Optional
:mimedependency enables content-type inference for file fulfillment; without it, files default toapplication/octet-stream. Browser.new_context/2acceptsservice_workers: "block"for routing tests.
[0.13.0] 2026-10-01
Added
Connection.unsubscribe_sync/3removes channel delivery and managed event ownership before returning. Both synchronous and asynchronous removal leave other recipients and explicit subscriptions intact.- Page
:frame_navigatedevents cover main and child frames, including frames created after registration, through existing subscriptions andEventWaiter.
[0.12.1] 2026-09-21
Fixed
- Restore
js_logger: falseas an alias fornilto disable JavaScript logging. Console messages and page errors no longer crash the connection withfalse.
[0.12.0] 2026-09-16
Added
- Add
Locator.evaluate/2, with strict lazy resolution under the locator timeout, unlimited JavaScript evaluation and disposal, and Playwright JS cleanup error precedence. - Add
ElementHandle.evaluate/2anddispose/2. - Add
Frame.expect_result/2to retain assertion diagnostics;expect/2keeps its boolean behavior.
[0.11.0] 2026-09-15
Added
Frame.snapshot/2for an atomic read of the cached URL, document request, and client-generated document identity.- Optional
EventWaitertransforms that run on capture inside the waiting task. - Managed opt-in event subscriptions: the first waiter enables an event and the last releases it. Explicit channel subscriptions remain active independently.
Frame.document_request/2to read the committed document's request without event subscriptions, preserving it across same-document navigation.Request.response/2to retrieve a request's response without subscribing to response events, returningnilwhen the request fails without a response.
Changed
- Frame URL/load-state waits use a separate task for each caller. The connection caches current frame state; per-frame recorder processes are removed. Public results stay synchronous, and URL predicate errors affect only that caller.
Fixed
- Download waiters validate their own options, excluding raw event transforms and
subscription overrides to preserve the
Downloadresult. - Clean up abandoned frame waits when callers exit and discard recorded frame state when the connection closes.
[0.10.0] 2026-09-15
Added
- Download handles with browser-provided filename and URL, reusable through
Download.from_event/2,Download.save_as/3, and explicitDownload.delete/2. Page.expect_download/2andPage.await_download/1for explicit arm/action/await download capture, with an optional predicate on download metadata.EventWaiter.arm/3,await/1, andcancel/1for one-shot protocol events, using linked tasks and ref-tagged replies, with synchronous registration, one deadline from arming, optional event predicates, and owner/connection lifecycle handling.:infinitydisables the event timeout.
Changed
- Breaking:
timeout: 0now means no waiting throughout the client. Protocol commands time out without being sent; frame URL/load-state waits check cached state once. Replacetimeout: 0withtimeout: :infinitywhere unlimited waiting was intended. - Missing connections, normal stops, supervisor shutdowns, and response timeouts return error results at the connection boundary. Other process exits and URL predicate bugs propagate instead of being converted to ordinary error results.
Fixed
- Discard unrelated protocol events from event waiters without extending their deadline, preventing mailbox growth while waiting on busy channels.
- Support
:infinityin frame URL/load-state waits and keyboard actions without timeout arithmetic errors. Keyboard delays cannot extend a zero timeout. - Artifact saves share one timeout across stream reads, clean up failed
transfers, create parent directories, and preserve existing destinations on
failure. Stream cleanup runs in an
afterblock and preserves the transfer result. Saving leaves the source artifact available to other readers. - Support
:infinitycommand timeouts using Playwright's zero-timeout wire value.
[0.9.0] 2026-09-08
Added
- Typed local and
PlaywrightEx.FilePayloadin-memory uploads throughFrame.set_input_files/2and the newElementHandle.set_input_files/2, including file-chooser handles and empty selections. #80 - Playwright 1.63 APIs for structured ARIA snapshots, OPFS and WebAuthn storage
state, browser-context event subscriptions (including
dialog_closed), visible and cross-frame selectors, and expanded browser launch options.
Changed
- Require Playwright 1.63 or newer and use it as the sole protocol baseline. Older local drivers are rejected, and remote connections advertise 1.63 and reset their protocol state after disconnects.
- Adopt Playwright 1.63's HTTP-credential and tracing wire formats while retaining the existing map-or-list public credential API.
Fixed
- Align channel options, events, and results with Playwright 1.63, including headers, enums, cookies, frame polling and selection, subscriptions, tracing modes, void results, and protocol logs.
- Correct channel lifecycle tracking across initialization, creation, adoption, disposal, and page/frame ownership; console and page errors now reach subscribers.
- Support every Playwright 1.63 serialized-value variant without altering opaque JSON keys or creating atoms from untrusted data.
- Harden port framing, stderr isolation, and remote artifact cleanup.
[0.8.0] 2026-08-27
Changed
- Require Playwright 1.62 or newer. Command timeouts are now sent as protocol metadata, matching the Playwright 1.62 driver contract. The bundled development dependency is updated to 1.62, and the local port transport warns when an older driver is detected.
- Preserve both the protocol error and
error_detailsinPage.expect_screenshot/2errors as{:error, {error, error_details}}. #58
Removed
- Support for the Playwright 1.60 expectation response format. #58
[0.7.1] 2026-06-19
Added
- Warn about playwright version < 1.61.0 (port transport only). Commit cd9e98e
[0.7.0] 2026-06-16
Fixed
- Support the Playwright 1.61
Frame.expectwire contract. 1.61 stopped returning%{matches: boolean}and now signals the assertion outcome by success-vs-error: a non-match returns a protocol error carryingerror_details.Frame.expect/2now yields a plain{:ok, boolean}under both 1.60 and 1.61, sophoenix_test_playwright'sassert_has/refute_haskeep working.Serialization.deserialize_arg/1also raises a descriptive error on unknown serialized shapes instead of a bareCaseClauseError. Commit d6d9ddc, #57, @oliver-kriska
[0.6.1] 2026-06-16
Added
- Accept all supported options to
Frame.goto. Commit 8e96071, #49, @s3cur3 Page.expect_screenshot/2. Commit 929b90e, #56, @Wigny
Fixed
- Handle
viewport: nilto disable default viewport. Commit 8139523, #46
[0.6.0] 2026-05-05
Added
PlaywrightEx.Artifactfor saving and deleting Playwright artifact files. Commit 8178f7cPlaywrightEx.BrowserContextclock helpers:clock_install/2andclock_fast_forward/2. Commit 7b6b977, #30PlaywrightEx.BrowserContext.storage_state/2andPlaywrightEx.BrowserContext.set_storage_state/2. Commit bcb5b16, #35, @probably-not:envoption for local Port transport environment variables. Commit 0095f7f, #34, @probably-notPlaywrightEx.Page.bring_to_front/2to activate a page tab. Commit 7348fa4, #32
Removed
- Frame
url/2helper, which is not a supported Playwright server operation. Commit 9490384
Fixed
:ignore_https_errorsnow serializes to Playwright's requiredignoreHTTPSErrorscasing. Commit 80f28be, #45
[0.5.0] 2026-03-06
Added
PlaywrightEx.Frame:is_visible/2,is_checked/2,is_disabled/2,is_enabled/2,is_editable/2,get_attribute/2,input_value/2,text_content/2,inner_text/2,focus/2,dispatch_event/2,wait_for_function/2. Commit 8684fda, #22, @oliver-kriskaPlaywrightEx.Frame.wait_for_selector/2:stateandstrictoptions. Commit 8684fda, #22, @oliver-kriskaPlaywrightEx.BrowserContext.add_init_script/2andPlaywrightEx.Page.add_init_script/2. Commit 74e93f6, #23, @probably-notPlaywrightEx.unsubscribe/2and connection-level unsubscribe support. Commit 319a69bPlaywrightEx.Frame.wait_for_load_state/2andPlaywrightEx.Frame.wait_for_url/2with event-based navigation waiting. Commit 027b0fa- Per-frame event recorder process to keep waiter subscriptions continuous across waits. Commit 027b0fa
PlaywrightEx.Page.expect_url/2for explicit URL expectations on pages. Commit 027b0fa- Regex support in argument serialization/deserialization using protocol-native
{r: %{p, f}}values. Commit 027b0fa PlaywrightEx.Page.reload/2to reload current page. Commit f3c5b21, #25, @wjrtz
Fixed
PlaywrightEx.Frame.wait_for_selector/2: crash whenstateis"hidden"or"detached"(result has no element). Commit 8684fda, #22PlaywrightEx.BrowserContext.add_init_script/2andPlaywrightEx.Page.add_init_script/2: usesourceparameter name required by Playwright protocol (instead ofcontent). Commit 3fd54a1- URL regex expectations now send Playwright-compatible string regex flags. Commit 027b0fa
- Frame waiter exit errors preserve normalized reason atoms in error metadata. Commit 027b0fa
[0.4.0] 2026-02-09
Added
- Support remote Playwright server via websocket. Commit 63fc6eb, @carsoncall
[0.3.2] 2026-01-30
Fixed
- Typespec bugs. Commit 7275ef9
[0.3.1] 2026-01-30
Added
- Tracing groups in preparation for
PhoenixTest.Playwright.step/3:PlaywrightEx.Tracing.group/3. Commit 545bc4d, @nathanl
[0.3.0] 2025-12-24
Added
PlaywrightEx.Page.mouse_move/2,mouse_down/2,mouse_up/2for low-level mouse control. Commit 530e362, @nathanlPlaywrightEx.Frame.hover/2for hovering over elements (supports manual drag operations). Commit 530e362, @nathanl
Fixed
[0.2.1] 2025-11-28
Changed
- Suppress node.js errors on termination
[0.2.0] 2025-11-19
Changed
- Add typespecs and docs
- Make channel function input and output consistent
[0.1.2] 2025-11-14
Changed
- Extract
PlaywrightEx.Supervisor(spawnPortServeroutside ofConnection)
[0.1.1] 2025-11-14
Fixed
- Memory leak: Free memory when playwright resource is destroyed (handle
__dispose__messages)
[0.1.0] 2025-11-13
Added
- First draft