v0.11.0

Current Status

• Chromium 82.0.4057.0. Passes 99% (792/802) tests
• Webkit 13.0.4. Passes 99% (792/802) tests
• Firefox 73.0b13. Passes 95% (763/802) tests

Detailed status can be found at IsPlayWrightReady?

Breaking API Changes

• browserType.launch has changed. Playwright now launches in 3 modes:

  • browserType.launch - default mode for testing. Each test should start with browser.newContext to obtain a clean environment. All new contexts are ephemeral, not persisted into the profile directory. It no longer accepts userDataDir option. There is no notion of the defaultContext anymore.
    (Note: you will still see an empty default context window when you run playwright in the headful mode. This is a side-effect of running the stock browsers. We are working on changing this behavior upstream so that clear Playwright run in this mode has no open windows on launch.)

  • browserType.launchPersistent - default mode for headful operations and those reusing the user profile. Instead of returning the Browser, it returns the BrowserContext loaded from the user data dir right away. It requires userDataDir to be passed as the first parameter.

  • browserType.launchServer - returns a BrowserServer (formerly known as BrowserApp) that can be connected to via the browserType.connect. Multiple clients can connect to the same server. Closing the Browser disconnects from the server. This mode is useful for certain test runner setups.

• Request interception

  page.setRequestInterception is replaced with the page.route. New method accepts the pattern of the urls to be intercepted and handles interception in place, instead of using the page.on('request') event. Note that we intend to move this method into the BrowserContext over time to make sure it affects popup windows.

• Viewport

  • page.setViewport is renamed to page.setViewportSize. It only allows resizing the viewport, does not allow changing it from mobile to desktop on the fly. Old method was making an implicit reload when switching device type and we did not want that to happen.

  • page.viewport() is renamed to page.viewportSize()

New APIs

• new browser.newPage - convenience method that creates a new context and a page inside that context. Closing the page closes the context. Useful when you only run single-page tests in your contexts.

• new page.check() and page.uncheck() - toggle your checkboxes.

• new browserContext.on('close') event - tells when the context is destroyed (disconnected from the server).

• new browserType.downloadBrowserIfNeeded() - when you use playwright-core npm that does not download browser by default, you can use this method to fetch them on demand.

• new frame.frameElement() method

• new page.route - substituted the page.setRequestInterception api.

• new page.viewportSize() - used instead of page.viewport.

In addition to this, all playwright packages now expose the same API and are only different in
the set of browsers they download:

• playwright - downloads all 3 browsers (chromium, webkit & firefox)
• playwright-core - does not download any browsers. Handy together with browserType.downloadBrowserIfNeeded()
• playwright-chromium - downloads only chromium
• playwright-firefox - downloads only firefox
• playwright-webkit - downloads only webkit

Bug Fixes

#808 - [BUG] rimraf causes failure with multiple browsers on Windows
#814 - [BUG] playwright- and playwright have different export signatures
#817 - [Feature] XPath staring with "(//" should be detected as such
#823 - [Feature] Allow skipping specific browser downloads
#839 - [Feature] Frame.frameElement
#857 - [BUG] Firefox: bundle ff-specific preferences with binary
#887 - [BUG] Cannot read property 'width' of null for Webkit screenshot
#914 - [BUG and temporary fix] Open Firefox as the frontmost window (macOS-specific)
#942 - [BUG] WebKit under debug crashes on Windows
#955 - [Feature] Expose Rawer V8 coverage information
#979 - [BUG] Missing blur and focus events

Raw Notes

d29625c - chore: generate browser versions when doing release (#999)
1eabd18 - test(firefox): unskip passing url hash test (#998)
b041ce6 - devops: enable debugging on WK Windows
4d7e531 - fix(webkit): wait for the pipe ready on windows (#997)
cd4e9da - feat(coverage): export raw v8 coverage (#976)
7ec3bf4 - test: fix locale tests on mac
b181b34 - test: attempt to normalize locale tests
b96d985 - test: fix locale expectations on non-Mac (#994)
25022e4 - feat(api): introduce default timeouts on BrowserContext (#992)
e744c53 - chore(webkit): bump webkit version to 1150 (#991)
f7fb35b - fix(windows): wait for pipe available again (#993)
f8f818f - Revert "Revert "feat: do not wait for first page in non-persistent mode (#939)""
71892b4 - Revert "feat: do not wait for first page in non-persistent mode (#939)"
c15534f - fix(locale): document locale parameter (#990)
cb63021 - test: add test for navigator.userAgent in popups (#985)
05f8d00 - test: fix service worker test (#988)
2e0d89e - fix(firefox): roll to 1029 and unskip passing tests (#984)
d790b4c - fix(test): default DEBUGP to false (#989)
8ed88c9 - feat(webkit): introduce BrowserContext({language}) (#972)
8006b2c - fix(webkit): avoid UnhandledPromiseRejection (#986)
991b89f - browser(webkit): rebase WebKit on r256488 (#973)
53fa629 - fix(): emit focus events in headful (#982)
a567123 - feat: do not wait for first page in non-persistent mode (#939)
c2ab1e3 - browser(firefox): misc fixes (#983)
d367a2e - chore(tests): log protocol messages when a test fails on the bots (#963)
8abf35c - feat(webkit): roll webkit to 1148 (#971)
d735de5 - feat: do not let users pass userDataDir to browserType.launch() (#974)
b7f48f4 - browser(webkit): layout before returning DOM.getContentQuads (#970)
b188f39 - devops: do not assume that checkout exists
5dbc880 - browser(webkit): print friendly tz names (#969)
c19a7be - chore: remove stub types definition
012bf67 - feat(webkit): emulate timezone on webkit (#968)
d26f47b - fix(platform): properly handle websocket error events (#967)
fbce290 - test: unskip passing Firefox tests (#966)
aa60a7c - docs(api.md): fix nit
bfaf191 - test: add missing tests (#965)
1d84f38 - fix(input): ensure input works as expected with page scale (#962)
ee9748b - feat(): roll chromium to r740847 (#964)
7ce49c2 - chore: remove WebSocket implementation (#961)
b0c0598 - fix(api): small-case all api event names (#959)
44941ad - browser(webkit): emulate time zone (#960)
1945ed7 - devops: run API coverage tests on linux (#958)
211cba4 - browser(webkit): use css (not dip) coordinates for input and content quads (#957)
79c4763 - feat(webkit): roll to r1145 (#954)
5956df5 - devops: re-factor github workflow internal structure (#956)
5f24205 - test: add a test for interception + service worker (#951)
a4d0187 - chore: mac build bots (#734)
1f29930 - devops: add docs & lint github workflow (#953)
0de625d - Revert "devops: add docs & lint github workflow"
7ec7f72 - devops: add docs & lint github workflow
9bbaa32 - browser(webkit): remove assert (#952)
3007541 - browser(webkit): do not intercept requests on the way to service worker (#948)
c8c4356 - test: add setInputFiles input event test (#944)
d05feec - feat(active): emulate active state on webkit (#941)
0d16d14 - fix(firefox): rely on bundled firefox preferences (#943)
da30847 - feat(firefox): apply emulation to all pages in the browser context (#931)
90367c1 - browser(webkit): emulate active and focused state (#940)
f25a27a - test: add a test for bounding box with page scale (#935)
ce38213 - browser(webkit): disregard dpi on windows (#938)
d37b67a - browser(firefox): do not wait for initial navigation in default context (#937)
efa567d - devops: fix firefox preferences build on mac
451ec72 - feat(): roll Chromium to r740289 (#936)
20e2bac - test: fix flaky page event test
5323700 - feat($wait): make $wait a shortcut for waitForSelector (#932)
3a32b14 - devops: bundle firefox preferences alongside with build.
6105d8a - fix(tests): fix test that was leaking a context (#933)
aae5fca - feat(api): make browser.newPage own the created context (#930)
ad9d6cc - feat: introduce browserType.downloadBrowserIfNeeded() (#834)
9ea8f49 - browser(firefox): attach to all pages in the browser context (#928)
8a35f40 - fix(events): deliver page.close upon disconnect in FF (#929)
c69...

v0.10.0

Current Status

• Chromium 81.0.4044.0. Passes 99% (837/845) tests
• Webkit 13.0.4. Passes 98% (746/758) tests
• Firefox 73.0b3. Passes 94% (726/776) tests

Detailed status can be found at IsPlayWrightReady?

Bug Fixes

#560 - Default profile for does not save data into specified folder
#565 - WebKit build flags
#583 - troubleshooting.md is missing
#606 - Missing a few device defs for landscape variants
#627 - Types exported from playwright-core, but not playwright
#658 - Strip the browser binaries
#661 - Typo in docs: dedault
#668 - request.continue() override with post data
#669 - Error 404 minibrowser-mac-10.13.zip
#696 - [email protected] types will not build
#705 - Firefox's WebSocket has no unguessable token suffix
#764 - File upload doesn't work
#783 - [Feature] Expose page.target()

Raw Notes

25f2a32 - feat: add Page.opener() to the API (#790)
1489fbd - fix: do not recommend yarn (#794)
b8199c0 - chore(webkit): use async/await to make eval more readable (#789)
0f305e0 - test(cookies): Rename clearCookies describe (#791)
84c93d2 - browser(webkit): plumb stderr from the web process to the main process (#792)
ef1d2fb - Revert "fix: move offline/cache/interception switches to BrowserContext (#748)" (#793)
9438136 - browser(webkit): enable some build features on win (#788)
4904459 - browser(webkit): introduce Browser.setLanguage (#781)
c57fd22 - fix(webkit): unflake Page.setContent (#786)
2bf88fd - test: start adding capability smoke tests (#784)
5cb19c6 - test: extract common headful tests (#785)
9a00e1d - docs: update webkit.md features
d054490 - docs: update readme
1f8e6e6 - doc: update readme
1c7db46 - doc: update readme
8a40fd0 - docs: update the readme intro sentence
76c22b7 - docs: bump Chromium version (#778)
adc5e3b - browser(webkit): bump WebKit to r1128 to check binary stripping
b77b31c - devops: strip linux binaries
24c5df6 - docs: add webkit build flags table (#777)
e33e403 - chore: nits to issues template
293fc6f - chore: remove bad issue templates
902580b - chore: update issues template
b289bb7 - fix(filechooser): intercept file choosers lazily (#776)
985faeb - fix: avoid unhandled promise rejection in WKSession.send (#770)
fd3a930 - fix(webkit): roll webkit to 1127 (#775)
735c5e6 - browser(webkit): fix compilation on Mac (#774)
e131fe0 - fix(chromium): install libgbm (#773)
83b5d89 - fix(firefox): roll firefox to 1021 (#769)
adc91c9 - chore(docs): fix broken link for downloaded browsers (#772)
ca49d50 - test: disable firefox popup tests that rely on waitForLoadState (#768)
1344596 - feat(chromium): roll to r737027 (#771)
6c58f93 - browser(webkit): simplify isolated world handling (#766)
2b231c9 - fix(test): unflake waitForSelector when browser closes test (#767)
1ad6134 - browser(webkit): ensure user worlds created when attaching to new pages (#765)
f4640d1 - Revert "tests(accessibility): Remove unused browser goldens (#758)" (#763)
d590ab9 - tests(accessibility): Remove unused browser goldens (#758)
1b012e5 - fix: do actually catch worker initialization exceptions (#762)
603b9f5 - fix: make contentFrame cross-frame handles test pass (#761)
eb56804 - test: unflake owner frame test (#760)
c9544b9 - docs: add documentation for selector engines (#752)
f44d660 - feat(webkit): use consistent user agent for headful and headless (#756)
ce72198 - feat(webkit): roll webkit to 1124 (#736)
44829d6 - browser(firefox): wait for pending accessibility updates (#755)
bcc920c - browser(webkit): follow-up to update inspector file locations (#754)
0e6b44d - feat(selectors): selectors.register accepts function (#753)
87abfe0 - browser(webkit): roll to WebKit ToT 1/29/2020 (#737)
afc0222 - browser(webkit): do not crash when opening inspector on mac (#751)
6faf74b - fix: move offline/cache/interception switches to BrowserContext (#748)
9a126da - feat: lower the engine requirement to node 10.15.0 (#750)
7ea4110 - browser(webkit): expose worker's owner frame (#694)
e64fd17 - devops: fix firefox building script on Mac 10.15.1
fc93b88 - fix: typo (#740)
a65bf41 - test(browsercontext): cookies() is a BrowserContext function (#741)
492304b - feat(firefox): roll firefox to r1020 (#735)
b68a88a - test: enable passing modifiers test (#733)
ce7c8d7 - feat: introduce BrowserType.name() (#732)
184b25f - chore: windows bots via github actions (#678)
4a3bd60 - fix(test): fix race in confusing confuse with previous navigation test (#730)
89a9311 - chore(webkit): bump webkit revision to 1120 (#727)
5e5d193 - test: don't ignore random arguments (#726)
4c25180 - chore(webkit): do not call setPauseOnStart for each target (#725)
4b0ce1d - browser(webkit-wpe): do not preload about:blank into popups (#724)
09e97af - feat(wk,ff): amend method & postData upon continue (#703)
c35c65b - docs(api.md) Rename page to context in newContext (#723)
75f7ff3 - docs(api.md) Fix USKeyboardLayout link (#719)
7af1d12 - browser(firefox): use unguessable web socket address (#722)
460527d - fix(webkit): do not poll readyState if target is paused before first navigation (#721)
9d34f28 - docs(api.md) Rename page to context in newContext (#718)
62f4ed6 - feat(unit): add click test on animated target (#655)
c04ad14 - feat(launcher): gracefully close browser on sigint (#650)
3248749 - fix(webkit): make frames detect their initial load state (#690)
19da86b - browser(firefox): amend method & postData upon continue (#716)
38b5f76 - fix(test): wait for load state before checking opener of popup (#714)
2bef4ae - feat(api): introduce selectors.register method (#701)
9cd6157 - devops: add auto-rebase github action
2ddc987 - fix(webkit): initialize popups on start (#693)
a64fc0e - chore: fix missing device definitions (#708)
9554ef4 - docs: make individual FAQ items linkable (#712)
90d84e8 - docs(api): fix cdp session creation example (#709)
ff30235 - chore: fix package typo in packages README (#707)
53cdbc5 - docs: clarify relationship to Puppeteer (#711)
45e88f7 - browser(webkit): amend method & postData upon continue (#702)
023fa01 - fix: playwright-core types (#699)
e276430 - doc: require webSocket:true for endpoint availability (#706)
79ea30c - docs: sort classes by use (#700)
bd726ee - chore: bump version to v0.9.24-post
3e40b4e - chore: mark version 0.9.24
54f442e - fix: properly expose top-level devices (#698)
e9515f4 - browser(webkit): pause popups on start (#691)
89b5d2f - fix(setContent): manually reset lifecycyle for all browsers at the right moment (#679)
aa2ecde - browser(webkit): make popups functional in mac embedder (#689)
ee9c2b0 - chore: bump version to v0.9.23-post
03e2754 - chore: mark version 0.9.23
d7beaa7 - chore: bump version to 0.9.22-post (#684)
0a7005e - chore: mark version v0.9.22 (#682)
7128628 - feat(testrunner): ability to repeat test suites (#681)
541fa95 - fix(ownerFrame): correctly handle adopted node usecase (#677)
b3cd7a4 - browser(webkit): remove URL from TargetInfo (#676)
5a5016f - docs: inline superclass toc into classes for convenience (#663)
c850430 - docs(api.md): remove browser downloads section (#675)
6e4bf95 - fix(install): check macOS version to be 10.14 or higher (#671)
e65cc77 - fix(pw_run): Allow running from paths with spaces (#674)
1b8cfff - browser(webkit): fix GTK build (#673)
a779efe - browser(webkit): always dispose persistent context before exiting (#649)
9e0cf72 - docs(api.md): add missing docs (#664)
99414b0 - doc(page): Improve Page description (#665)
4b84973 - docs: api.md typos
7f46a09 - feat(webkit): roll to r1011 (#659)
d2bfe00 - browser(webkit): fix setOfflineMode (#656)
f03b648 - chore: removed build labels from readme
b4b7c5e - feat(webkit): enable user-data-dir tests for all platforms (#646)
63d5a73 - fix(types): export playwright-core types from playwright (#628)
5fdb3e2 - chore(webkit): roll to 1111 (#644)
2ae6466 - browser(webkit): support user-data-dir on win (#642)
b64604c - chore: replace pptr with pw (#643)
be19ae5 - feat(browserApp): kill and onclose (#641)
f1d1dfb - fix(webkit): rewrite global object retrieval errors (#640)
fb9ec96 - browser(webkit): support --user-data-dir on Linux (#610)
a4f27c1 - browser(webkit): fix compilation on Mac 10.15 (#638)
c453851 - api: introduce BrowserType with a single interface, update top-level api (#636)
199d094 - fix: make launch options in ffPlaywright optional (#637)
834698c - docs(readme): update hero snippet to illustrate single API (#631)
3abaced - chore(webkit): build wpe and gtk to different folders (#616)
f463d06 - browser(webkit): fix WPE compilation (#635)
12a4354 - browser(webkit): roll to r255078 (#633)
2b44d75 - test: move most launcher tests to common (#621)
ff87701 - doc(troubleshooting): add note about lack of node 8 support (#623)
03f37bc - doc(readme): add test status badges (#617)
69c5b2a - docs: clarify Puppeteer active status (#619)
060fbf7 - fix(workers): emit workerdestroyed event when clearing workers (#618)
056fbbd - fix(api): make pipe connection the default, expose webSocket launch option (#562)
b4b81ba - chore: move downloads to Azure CDN (#615)
6b8c40e - browser(webkit): respect --user-data-dir on MacOS (#579)
3b2993f - fix(docs): add back troubleshooting.md (#605)
866c602 - fix(firefox): disable ICC color correction based on OS display (#614)
c1cca19 - test: extract tests for webkit provisional page (#609)
4cf2180 - fix(docs): add docs for the websocket event (#612)
b8e2bba - chore: run lint on travis (#613)
74e9859 - feat(firefox): roll to 1018 (#604)
044ebd7 - fix: delete contexts from the map on navigation (#602)
ac2ba3c - fix(api): BrowserServer -> BrowserApp, resuse it between browsers (#599)
b4209e9 - test: move user-data-dir tests into shared location (#603)
a5019ea - fix(api): remove remoteAddress from api (#601)
23a668e - feat(firefox): support request interception...