playwright 0.11.0

on Node.js NPM

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)
c69dccf - feat(click): use browser-provided scrollIntoViewIfNeeded (#893)
72b9cf0 - feat(context): introduce BrowserContext close event (#918)
5fee93a - test: fix expect in jshandle spec (#927)
7802354 - fix(firefox): bring headful window to front on launch (#923)
49eea19 - feat(webkit): roll webkit to 1141 (#922)
29f4f18 - browser(webkit): allow beforeunload override when headful (#921)
251ad38 - fix(navigations): remove LifecycleWatcher, fix flakes (#882)
c03e8b7 - chore(tests): add types for tests (#915)
9da0229 - chore: bump rimraf to 3.0.2 (#916)
4fcc63f - chore: remove usages of mime module from infrastructure
84f5700 - feat(api): rename browserContext() to context() in the apis, remove url from newPage (#906)
4d84e35 - fix(upload): detect mime type from file extension (#911)
79b7a84 - fix(screenshot): be careful w/ default viewport, extract common logic (#913)
2dd11ea - docs: remove browser.newPage from README
50f96eb - docs: update readme to address browser changes questions
e9c1477 - fix(webkit): fix remaining tests on windows (#905)
f4734ef - feat(testrunner): show workerId in verbose mode
d71c9e0 - feat(webkit): roll webkit to r1140 (#904)
e2710de - browser(webkit): do not activate headless window on browser start (#900)
36344de - tests: consistently use platform constants (#899)
3acc65d - devops: teach //browser_patches/webkit/build.sh to build both GTK & WPE
73148fd - chore(lint): add @typescript-eslint/no-unnecessary-type-assertion rule (#898)
487d394 - chore(lint): add @typescript-eslint/type-annotation-spacing rule (#897)
8712359 - devops: prettify telegram messages
42c2cfc - fix(pipe): sort out pipes on platforms (#895)
0ed43e8 - feat(webkit) await the reading from pipe message (#894)
cdbfc4c - browser(webkit): report inspector pipe is listening via stdout (#892)
8c2302d - browser(webkit): do not navigate popups to about:blank on Win (#886)
d397bb1 - feat(): roll chromium to r739261 (#885)
fe2431e - feat(webkit): roll webkit to r1137 (#884)
fee83b1 - fix(api): page.viewport -> page.viewportSize (#878)
c33a12d - feat(firefox): ensure that new pages get browser context userAgent option (#872)
bc91259 - browser(webkit): use random ephemeral session ids on Mac (#881)
06a7d7e - docs(api.md): missing arguments for functions in page.route (#880)
f15690d - browser(webkit): roll WebKit to tip-of-tree 2/6/2020 (#877)
ffc1022 - fix(doclint): fix doclint for new typescript (#879)
ffc8f96 - browser(firefox): bump build number to r1025
9f0bbff - browser(firefox): pause page on creation to handle emulation messages (#871)
75340f3 - chore: Note that (code) coverage is only available for (#867)
8c6faab - browser(firefox): roll firefox to upstream's beta (#876)
99d0689 - tests: explicitly close contexts for browser.newPage (#875)
126eb50 - fix(transport): dispatch messages in separate tasks (#841)
6202ff1 - browser(firefox): use guids for browser contexts, delete contexts on disconnect (#866)
a547aa7 - feat(connect): allow multiple webkit connections over web socket (#863)
f49d63f - test: remove fdescribe
5152540 - test(cookies): add more isolation tests (#869)
a72784a - fix(test): properly clean input field (#860)
fa6a5ed - chore: fix typo in aliases
177a1d4 - chore: add "unit", "wunit" and "funit" aliases (#859)
6318ba6 - feat(frame): introduce frame.frameElement (#856)
4be39f8 - chore(types): upgrade to typescript 3.7.5 (#855)
4aa155e - docs(api.md): fix link
cd68619 - chore: fix protocol-types-generator to work with new API
55b6fe2 - feat(launch): introduce client, server & persistent launch modes (3) (#854)
28c4a16 - fix(): ensure we resume service worker before detaching from it (#850)
a4c40ff - test: make sure page.fill actually clears an input (#851)
1b1ed08 - browser(webkit): introduce DOM.scrollIntoViewIfNeeded (#847)
0cc26c0 - browser(firefox): introduce Page.scrollIntoViewIfNeeded (#848)
a2ab645 - feat(launch): introduce client, server & persistent launch modes (2) (#840)
0f1a42a - docs(readme): fix API link to always point to last released API
f114255 - devops: attempt to fix linux bot
2e0f3e3 - docs: split docs to npm version and latest (#846)
0518625 - feat(launch): introduce client, server & persistent launch modes (1) (#838)
bdf8e39 - feat(goto): assume http:// for localhost navigations (#825)
8f1df5e - fix(): pause workers on start to not miss any events (#832)
4b761f4 - test: expect current behavior for cross-frame js handles (#833)
6dc88bc - feat(webkit): roll WebKit to r1134 (#835)
0c2a2e1 - fix: properly nullify error stacks (#836)
e3e2da3 - feat(check): introduce page.check/uncheck (#826)
2ba5e84 - docs: we are Playwright, not PlayWright
3ef2313 - docs: fix dead link for element handle (#827)
05d4746 - feat(selectors): temporarily remove zs engine (#824)
1059e22 - fix(fill): make fill work for input[type=number] (#819)
b82bc5f - feat: treat selectors with leading '(//' as xpath (#821)
cea036a - feat: change vendor package exports (#818)
8028fb0 - feat(route): migrate from request interception w/ events to page.route (#809)
84edefd - browser(webkit): follow up to Browser.setLanguage, fan out changes (#801)
387b895 - browser(webkit): build more wk features (#807)
0a16b60 - browser(webkit): fix crash when a worker is terminated while logging (#797)
0007439 - doc(api.md): Fix setPermissions link (#806)
fce3842 - chore: bump version to 0.10.0-post (#796)