Commit graph

2074 commits

Author SHA1 Message Date
Valentín Costa 93e020d483
docs(class-test.md): add missing R in the word returned (#22252) 2023-04-07 13:57:28 -07:00
任跃兵 2b1a121133
Update class-consolemessage.md (#22261) 2023-04-07 13:51:46 -07:00
Pavel Feldman 3400d62a7a
chore: discourage networkidle (#22247) 2023-04-06 13:00:34 -07:00
Dmitry Gozman 08cef43e82
feat(locator): remove locator.and and locator.not (#22223)
Not shipping for now, after API review.
2023-04-05 16:28:13 -07:00
Dmitry Gozman 35afb056ea
feat(locator): filter({ hasNotText }) (#22222)
The opposite of `filter({ hasText })`.
2023-04-05 14:13:28 -07:00
Dmitry Gozman 5734f11a69
docs: update Locator.or example (#22220) 2023-04-05 13:13:10 -07:00
Sébastien Richert 88544d537b
docs(class-request.md): rephrase definition of request timing responseStart (#22170) 2023-04-05 13:11:38 -07:00
Dmitry Gozman bc1de5f28d
feat(locator): filter({ hasNot }) (#22219)
This is the opposite of `filter({ has })`.
2023-04-05 12:45:46 -07:00
Johannes Loher bd698efaef
fix(webServer): follow relative redirects when checking the url (#22035)
Fixes https://github.com/microsoft/playwright/issues/22144
2023-04-05 10:39:35 +02:00
Dmitry Gozman d7b3836752
chore: revert console and dialog events on BrowserContext (#22195)
This reverts #22033 and #21943, since there will be no immediate
benefits in v1.33.
2023-04-04 13:13:52 -07:00
Pavel Feldman f8f9ee6a25
chore: introduce Reporter.onExit (#22176)
Fixes https://github.com/microsoft/playwright/issues/22173
2023-04-04 10:50:40 -07:00
Rob Bayliss 966f2392a0
docs(test-configuration): fix missing reference to devices in snippet (#22162) 2023-04-04 15:43:51 +02:00
Max Schmitt 590013e27b
docs(python): fix WebSocket types (#22155)
Fixes https://github.com/microsoft/playwright-python/issues/1841
2023-04-03 13:21:33 -07:00
Pavel Feldman ee39af260d
chore: discourage waitForSelector (#22133) 2023-03-31 20:24:08 -07:00
Andrey Lushnikov 5223c1ba39
feat: add timeout to electron.firstWindow() method (#21863)
Fixes https://github.com/microsoft/playwright/issues/21846
2023-03-31 15:35:54 -07:00
MarcNum fbdafc5fe3
feat: Adding trace option 'on-all-retries' (#21985)
Fixes: #21860
2023-03-31 13:04:24 -07:00
Yury Semikhatsky e86b0cf0ce
docs: discourage test lists (#22125)
Fixes https://github.com/microsoft/playwright/issues/22109
2023-03-31 11:10:13 -07:00
Debbie O'Brien a567cf083f
docs: remove cli guide (#21997) 2023-03-31 10:48:05 +02:00
Dmitry Gozman 539d9873c2
feat: rename Locator.filter(locator) to Locator.and (#22101) 2023-03-30 14:41:30 -07:00
Yury Semikhatsky ebcb37f61e
docs: add warning about browser policy (#22103)
Fixes https://github.com/microsoft/playwright/issues/22016
2023-03-30 13:09:57 -07:00
Dmitry Gozman e6148bb725
feat: Locator.not(locator) (#22066) 2023-03-30 08:52:30 -07:00
Debbie O'Brien 870abae9a1
docs: remove debug selectors (#22027) 2023-03-30 15:20:28 +02:00
Debbie O'Brien 2c9d65b5ed
docs: change port to url (#22029) 2023-03-30 15:18:59 +02:00
Max Schmitt 0c4eedbabe
docs: support code block titles (#22068)
Fixes https://github.com/microsoft/playwright/issues/21461
2023-03-29 23:15:39 +02:00
Yury Semikhatsky 026e49b076
chore: add snippet to the error message (#21991) 2023-03-29 14:07:14 -07:00
Dmitry Gozman 6929214dbf
feat(expect): expect(locator).toBeAttached() (#22067)
Fixes #13467.
2023-03-29 11:09:17 -07:00
Dmitry Gozman 3b359e27b7
feat: BrowserContext.on('dialog') (#22033)
Dialogs created early during page initialization are only reported on
the context, with `page()` being `null`.
2023-03-28 13:15:55 -07:00
Dmitry Gozman 00d98770ee
docs: improve "Parent element locator" section (#22040)
Recommending `Locator.filter`, with a fallback to `xpath=..`
2023-03-28 13:15:25 -07:00
Dmitry Gozman f502c72f2b
feat: browserContext.on('console') (#21943) 2023-03-27 16:35:05 -07:00
Dmitry Gozman 525097d465
feat: Locator.filter(locator) (#21975)
Produces a locator that matches both locators.
Implemented through `internal:and` selector.

Fixes #19551.
2023-03-27 14:29:30 -07:00
Dmitry Gozman 47e5c02a21
fix(test runner): update default testMatch (#22006)
The intent of default test match is allowing `example.spec.ts` and
`example.test.ts` files. However, it was also matching `test.example.ts`
that should not be considered a test by default.

Fixes #21979.
2023-03-27 14:28:44 -07:00
Sébastien Richert 591e4ea976
feat: Restrain sending http credentials on a specific origin (#20374)
For security purpose, we would like to restrain sending HTTP credentials
to only the specified server. The idea is to give the ability to specify
a origin (scheme://host:port) additionally to current pair
username/password. When an authorization response is received from
servers, the credentials are sent only if the server origin in the
request matches case insensitive the specified origin.
2023-03-27 08:52:00 -07:00
Tim Deschryver 45faf0cd80
docs: add --ui to CLI options (#21966) 2023-03-24 15:19:02 -07:00
Andrey Lushnikov 97d2c4a635
doc: add missing commas in code snippets (#21965)
Fixes https://github.com/microsoft/playwright/issues/21957
2023-03-24 13:42:12 -07:00
LongLiveY96 0293c26212
docs(locators): fixed a descriptive error about Chaining Locators (#21902) 2023-03-24 15:03:48 +01:00
Faisal Salman 086dec364b
docs(java): fix syntax error in Java example of JSHandle.getProperties (#21901) 2023-03-23 08:19:17 -07:00
Dmitry Gozman d10fac4f6a
feat: Locator.or(locator) (#21884) 2023-03-22 15:28:59 -07:00
Andrey Lushnikov 65da1d2835
docs: do not use HTML tags (#21889) 2023-03-22 13:29:14 -07:00
Andrey Lushnikov 6bd002db27
docs: add release notes for js (#21886) 2023-03-22 13:05:46 -07:00
Debbie O'Brien 93d20ffb52
docs: add images to dependencies (#21757) 2023-03-20 15:30:48 +01:00
Andrey Lushnikov 32d33cb8d5
chore: cut 1.32 (#21773) 2023-03-17 19:36:43 -07:00
Yury Semikhatsky a61b544932
docs(java): add waitForCondition method (#21768)
https://github.com/microsoft/playwright-java/issues/1228
2023-03-17 13:02:59 -07:00
Dmitry Gozman f484b833ae
docs: update getByLabel docs to mention aria attributes (#21765)
References #21624.
2023-03-17 12:48:07 -07:00
Yury Semikhatsky 95e7d3aabc
chore: hide store from public (#21763) 2023-03-17 11:50:44 -07:00
Dmitry Gozman 3a80d119e0
chore: update routeFromHAR options for release (#21764) 2023-03-17 11:49:45 -07:00
Max Schmitt 4a66cca124
docs(dotnet): remove note that there is no .NET Jammy Docker image (#21752)
Fixes https://github.com/microsoft/playwright-dotnet/issues/2515

Signed-off-by: Max Schmitt <max@schmitt.mx>
2023-03-17 16:14:35 +01:00
Debbie O'Brien 461723912f
docs: add missing option and change to table (#21711) 2023-03-17 07:50:50 +01:00
Max Schmitt 771abe15fb
docs(node): consolidate JS/TS snippets for guides (#21710)
https://github.com/microsoft/playwright/issues/21385
2023-03-16 21:16:18 +01:00
Dmitry Gozman 2074a51299
docs: fix details about WorkerInfo vs TestInfo availability (#21699)
Fixes #21695.
2023-03-16 12:36:34 -07:00
Max Schmitt 3ceac4bf53
docs: drop duplicate JS code snippets from test-api (#21466)
https://github.com/microsoft/playwright/issues/21385
2023-03-16 19:01:15 +01:00
Max Schmitt 6c75c01fde
docs(dotnet): don't use C# option names (#21709)
Fixes https://github.com/microsoft/playwright-dotnet/issues/2513

Drive-by: hide C# option names
2023-03-16 09:23:31 -07:00
Dmitry Gozman 40a6eff8f2
feat: support name option in tracing.startChunk() (#21692) 2023-03-15 17:34:56 -07:00
Dmitry Gozman 69a94ed044
docs: update default timeouts in js to be zero and mention config (#21675)
Fixes #19018.
2023-03-14 16:34:30 -07:00
Pavel Feldman 27048adebe
chore: introduce testInfo.testId (#21670) 2023-03-14 15:58:55 -07:00
Jonatas Emidio 910b963ca6
docs: Avoid third-party with Network API (#21629)
docs: Avoid third-party with Network API

On the [Avoid testing third-party
dependencies](https://playwright.dev/docs/best-practices#avoid-testing-third-party-dependencies).
Instead of only inform about third-party, this sesison is a good place
to share about Network API. Guiding them in not only inform about
avoiding third-party, but also explaining how to deal with this use
case.

Signed-off-by: Jonatas Emidio <jonatasemidio@gmail.com>
2023-03-14 11:40:03 -07:00
Drew Miller d8b6b988cd
docs: spelling fix (#21573) 2023-03-14 19:04:02 +01:00
Max Schmitt ba6b41d017
docs(locator): fix Locator frameLocator params (#21662) 2023-03-14 17:15:43 +01:00
Dmitry Gozman c9837dfcc7
docs: add flakiness note to locator.all (#21645) 2023-03-13 19:33:36 -07:00
Debbie O'Brien c9007d952b
docs: remove youtube video for other langs (#21616) 2023-03-13 18:00:50 +01:00
Debbie O'Brien 0610705546
docs: add video to trace viewer docs (#21568) 2023-03-10 09:45:55 -08:00
Max Schmitt 7746807d9f
docs(api-testing): fix broken snippet (#21499)
Fixes https://github.com/microsoft/playwright/issues/21476
2023-03-09 16:20:19 +01:00
Max Schmitt 2aeebc82d7
docs(test-parameterize): defineConfig is no type import (#21523)
https://github.com/microsoft/playwright/issues/21519
2023-03-09 16:19:56 +01:00
Max Schmitt c9eac69f2b
fix(types): accept string in expect().toMatch() (#21454)
Fixes https://github.com/microsoft/playwright/issues/21453
2023-03-07 17:53:50 +01:00
Max Schmitt 68b351c603
docs(browsers): code snippet follow-ups (#21383)
Follow-up on
https://github.com/microsoft/playwright/pull/21051?notification_referrer_id=NT_kwDOARJsJbM1NjYxMzQ2ODgxOjE3OTg0NTQ5#event-8629388219.
2023-03-07 17:53:12 +01:00
Debbie O'Brien 2067d715ff
docs: screens codegen emulation (#21094) 2023-03-07 08:58:49 +01:00
Debbie O'Brien 135d68d8a9
docs: add video to release notes (#21441) 2023-03-07 08:57:36 +01:00
Debbie O'Brien e22c048276
docs: Config page name updates (#21440) 2023-03-07 08:57:13 +01:00
Adi bdefaa9f9e
docs: added missing generic declaration (#21442) 2023-03-06 22:03:43 +01:00
Debbie O'Brien 7c44eab644
docs: add dependencies to global setup (#21438) 2023-03-06 21:04:04 +01:00
Debbie O'Brien f6095f6a5e
docs: fix title cases (#21439) 2023-03-06 20:52:58 +01:00
Debbie O'Brien 9e47c450c7
docs: Rework config (#21384) 2023-03-06 17:17:34 +01:00
Debbie O'Brien 948755226f
docs: add projects page (#21332) 2023-03-06 16:46:55 +01:00
Debbie O'Brien e305d207fe
docs: merge emulation config (#21340) 2023-03-06 16:43:32 +01:00
Debbie O'Brien 6d549320b1
docs: add doc on webserver (#21378) 2023-03-06 16:42:54 +01:00
Debbie O'Brien b6765862f1
docs: add network example from advanced config (#21380) 2023-03-06 16:42:19 +01:00
Dmitry Gozman 0c5d46bb94
feat: allow chaining locators with Locator.locator(anotherLocator) (#21391) 2023-03-03 14:50:53 -08:00
Debbie O'Brien a8b5f51be1
docs: add page for global setup teardown (#21376) 2023-03-03 11:27:21 -08:00
Debbie O'Brien e29a6e7bb0
docs: update test reporters (#21337) 2023-03-03 07:52:28 -08:00
Debbie O'Brien 744739a3d0
docs: improve config for test parallel (#21333) 2023-03-02 18:49:41 +01:00
Debbie O'Brien e10199fd5a
docs: retries update to add configuration (#21338) 2023-03-02 08:33:30 -08:00
Pavel Feldman 2cbafd7adf
chore: mark waitForNavigation as deprecated consistently (#21309) 2023-03-01 12:40:50 -08:00
Debbie O'Brien 9b78b7151e
docs: improve running tests (#21266) 2023-02-28 20:58:24 +01:00
Debbie O'Brien d0d1d144f1
docs: Browsers page rework (#21051) 2023-02-28 18:09:44 +01:00
Everton Eckert Schneider cb5a4845b3
docs: delete the URI /wd/hub Selenium Grid addresses. (#20971)
Selenium 4 does not use `/wd/hub` as part of the Hub URI.

As seen in the example
https://www.selenium.dev/documentation/grid/getting_started/#metadata-in-tests,
it registers the Selenium Grid URL simply as `http://gridUrl:4444` (no
`/wd/hub`).

When trying to access the URL ending with `/wd/hub`, it returns the
message 'Unable to find handler for (GET) \u002fwd\u002fhub'.

Signed-off-by: Everton Eckert Schneider <everton.schneider@gmail.com>
2023-02-27 19:47:19 -08:00
NoamGaash e17e0e40f8
feat(routeFromHAR): add arguments (#21223) 2023-02-27 15:27:38 -08:00
Joel Einbinder eba86fcc53
fix(doc): electron evaluate evaluates in electron not worker (#20892) 2023-02-27 12:49:25 -08:00
Gonçalo Basto 7c6630b1a2
docs: add custom reporter options documentation (#21144) 2023-02-24 12:29:08 +01:00
Max Schmitt 78bc6f4d74
docs(python): add support for custom expect message (#21151)
https://github.com/microsoft/playwright-python/issues/1310
2023-02-23 13:25:00 +01:00
Yury Semikhatsky a81ce3f13d
docs(auth): wait for the response with cookies (#21114)
Fixes #21096
2023-02-22 14:02:27 -08:00
Max Schmitt 41d8f27d8f
docs: do not mention DockerHub anymore (#21101)
Fixes https://github.com/microsoft/playwright/issues/21095
2023-02-22 17:52:42 +01:00
Debbie O'Brien 135e9f8281
docs: add project info to running tests (#20995) 2023-02-22 09:47:19 +01:00
Max Schmitt 1432c406ad
docs: fix toMatch code snippet typo (#21077)
Fixes https://github.com/microsoft/playwright/issues/21014
2023-02-22 00:38:30 +01:00
Max Schmitt d0308d1924
docs: fix double code snippets (#21027)
Fixes https://github.com/microsoft/playwright/pull/20908
2023-02-20 18:13:01 +01:00
Dmitry Gozman 4c68829e39
docs: update auth docs to remove cross-run caching (#21008) 2023-02-18 09:15:16 -08:00
Dmitry Gozman 5483006499
chore: update release notes for 1.31 (#20997) 2023-02-17 14:25:57 -08:00
Debbie O'Brien d96d3c3381
docs: fix release notes (#20994) 2023-02-17 20:03:22 +01:00
Debbie O'Brien c0d9aa2c49
docs: new screenshots for langs (#20149) 2023-02-17 19:16:49 +01:00
Dmitry Gozman 6fbb265a58
chore: release notes for 1.31 for java, python, csharp (#20969) 2023-02-16 18:11:01 -08:00
Yury Semikhatsky ba6d055bc5
docs: Route.fetch.maxRedirects in java (#20968) 2023-02-16 17:02:12 -08:00
Yury Semikhatsky 09be9d6425
feat: key value store backed by filesystem (#20932)
Keys are used as a relative file path without any sanitization assuming
that the underlying fs will throw on error.
2023-02-16 16:48:28 -08:00
Yury Semikhatsky eadcab6b9f
fix(docs): move callback of Worker.waitForClose to the end of param list (#20966) 2023-02-16 15:32:12 -08:00
Debbie O'Brien e444632dec
Improve debug doc (#20924) 2023-02-16 21:05:44 +01:00
Dmitry Gozman 0b7f9055a3
chore: fix docs for python and java (#20962) 2023-02-16 11:48:38 -08:00
Dmitry Gozman ffc2477a00
chore: 1.31 release notes for js (#20933) 2023-02-16 09:35:01 -08:00
Debbie O'Brien 93b791d322
docs: update trace viewer video (#20925) 2023-02-16 17:10:56 +01:00
Dmitry Gozman e77e2d8c7f
chore: mark 1.32.0-next (#20929) 2023-02-15 16:15:42 -08:00
Yury Semikhatsky 90c4e6f9b2
chore: revert sharded html report (#20923)
We've decided not to ship it in the current form.

#10437
2023-02-15 12:38:03 -08:00
IlinAlekseyS 5899348936
fix(best-practices): delete dublicate sentence (#20885) 2023-02-15 20:03:56 +01:00
Dmitry Gozman 42c606e181
docs: improve authentication guide (#20882) 2023-02-14 11:34:28 -08:00
Debbie O'Brien b90b18daf3
docs: change videos to use new youtube component (#20899) 2023-02-14 17:09:53 +01:00
Andrey Lushnikov 72942e81d5
chore: fixes to toBeInViewport (#20870) 2023-02-13 15:21:40 -08:00
Andrey Lushnikov fdcd7b549d
chore: mark comparator option back as experimental (#20816)
This reverts commit 303c5998f8.

Reason for revert: I tried enabling `ssim-cie94` by default on
ionic-framework test suite, and it proves to be overly strict for their
usecase.
2023-02-13 11:11:44 -08:00
Debbie O'Brien ecc2e4aa57
docs: add videos for vscode guide (#20865) 2023-02-13 19:43:05 +01:00
Dmitry Gozman 77b598110f
fix(docs): inline java, js and csharp overrides (#20833)
This fixes the order of arguments as well as many incorrect arguments
around `WaitFor()` methods.
2023-02-10 15:14:28 -08:00
Andrey Lushnikov 68e170ef89
feat: implement expect(locator).toBeInViewport() (#20668)
The method accepts a `ratio` option to assert the ratio
of the element in viewport. `ratio` defaults to `Number.MIN_VALUE`.

NOTE: this reverts commit d950f5b6ee and
adds `ratio` option support + does the rename.

Fixes #8740
2023-02-10 04:33:22 -08:00
Dmitry Gozman 56276184ae
chore: inline docs from python.md (#20792)
These are currently messed up, with non-python options all over the
place.
2023-02-09 18:24:32 -08:00
Sander aaafd37e24
docs(ct): improve pinia instructions (#20644) 2023-02-09 08:59:11 -08:00
Dmitry Gozman 59121a3c37
chore: remove unnecessary extra options from docs (#20785)
Python-only methods should not reference js-only options.
2023-02-09 08:57:44 -08:00
Yury Semikhatsky a93cf767a1
feat: html reporter sharded option (#20737)
Make sharded report feature an opt-in:

```ts
{
   reporter: [['html', { sharded: true }]]
};
```

#10437
2023-02-07 22:21:50 -08:00
Andrey Lushnikov 303c5998f8
feat: release "comparator" option from experiment (#20720)
The option defines a comparator to be used to compare images.
Possible values are `"pixelmatch"` and `"ssim-cie94"`.

Note: This reverts commit 8167f8bf54.
2023-02-07 08:51:48 -08:00
Dmitry Gozman 33a05446d2
fix(expect): update docs to point to GenericAssertions instead of expect library (#20688)
Closes #20432.
2023-02-06 14:51:24 -08:00
Yury Semikhatsky 86dd29a15e
docs: custom selectors registration (#20687)
https://github.com/microsoft/playwright/issues/20424
2023-02-06 13:32:00 -08:00
Abe Hanoka 618bec0107
docs(downloads): add missing await to python-async snippet (#20663)
fixes #20662

---------

Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2023-02-06 14:26:48 +01:00
Boris Osipov 494497abbf
docs(chrome-extensions) update headless testing docs (#20643)
Update the documentation according to changes
https://bugs.chromium.org/p/chromium/issues/detail?id=1380881
2023-02-06 10:31:05 +01:00
Takuto Yuki 9787de92f3
docs(test-advanced): fix import config example (#20635)
https://playwright.dev/docs/test-advanced#same-tests-different-configuration

Missing include in config.ts file. add import `devices`.

Signed-off-by: Takuto Yuki <ppppp303@gmail.com>
2023-02-06 10:29:24 +01:00
Yury Semikhatsky 758246bb9e
docs: improve auth guide (#20602) 2023-02-03 16:51:44 -08:00
Max Schmitt df6f500730
docs: mention use-case for the Docker image (#20621)
Fixes
https://github.com/microsoft/playwright/issues/20589#issuecomment-1416263856
2023-02-03 14:03:55 -08:00
Sander adab7a817e
docs(ct): hooks and formatting (#20593) 2023-02-03 08:56:55 -08:00
Dmitry Gozman f46883e58e
feat(expect): add GenericAssertions documentation (#20564)
References #20432.
2023-02-01 16:55:52 -08:00
Dmitry Gozman 6f699cd346
docs: clarify headers propagation to redirects (#20572)
References #20501.
2023-02-01 16:55:03 -08:00
Pavel Feldman 421dd884a7
chore: implement --no-deps (#20569) 2023-02-01 16:32:13 -08:00
Pavel Feldman cb9ace6035
chore(test): move run options into config (#20568) 2023-02-01 15:25:26 -08:00
Dmitry Gozman 6ad4687f4d
feat(route): add maxRedirects option to Route.fetch (#20567)
References #20501.
2023-02-01 14:43:21 -08:00
Pavel Feldman 635b47025e
chore: expose project dependencies api (#20546) 2023-02-01 08:39:07 -08:00
Yury Semikhatsky 0d0968076e
docs: update .net console example comments (#20503)
https://github.com/microsoft/playwright-java/issues/1168
2023-01-30 09:10:22 -08:00
chimurai f72d400952
chore: fix typos (#20473) 2023-01-30 09:53:28 +01:00
Adi 32724cd5ce
docs: Added types to custom reporter typescript example (#20191) 2023-01-28 09:38:42 -08:00
Pob Ch 7cb1b2db39
docs(getting-started): fix typo (#20468)
Signed-off-by: Pob Ch <590650@gmail.com>
2023-01-28 12:02:53 +01:00
Yury Semikhatsky 532ca3f7b3
fix: throw on tap when hasTouch=false (#20457)
Fixes #20430
2023-01-27 15:51:57 -08:00
Sander 76cb09675a
docs(ct): pnpm install (#19841) 2023-01-27 14:33:20 -08:00
Pavel Feldman 841ac6ecb3
docs: remove third party js runners doc (#20405)
Fixes: https://github.com/microsoft/playwright/issues/20390

We are doing such a bad job documenting these third party approaches
that they bring more harm than benefit. We should let respective
integration owners own the documentation and link to it. I'll remove it
altogether for now.
2023-01-26 10:05:11 -08:00
Jeremy Hutchinson bc134551fb
docs(dotnet): add support for CDPSession (#20053)
Implemented in https://github.com/microsoft/playwright-dotnet/pull/2448

Signed-off-by: Jeremy Hutchinson <jrhutch@live.com>
Co-authored-by: Jeremy Hutchinson <jehutchi@microsoft.com>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2023-01-26 11:49:10 +01:00
Pavel Feldman 5761a62b1c
docs: clarify the null value for the viewport (#20333)
Fixes https://github.com/microsoft/playwright/issues/20284
2023-01-25 17:48:18 -08:00
Pavel Feldman fe1dd7818d
chore: extract task runner for global setup (#20345) 2023-01-25 15:38:23 -08:00
chamu228 112c7bda45
docs(java): fix Java doc of playwright create method (#20356) 2023-01-25 09:51:16 +01:00
Pavel Feldman 147bb6b292
chore: run global setup before onBegin (#20285) 2023-01-23 17:44:23 -08:00
Rob Donnelly ba0189f8d7
docs(test-parameterize): fix typos (#20178) 2023-01-23 09:28:22 -08:00
Harikrishna 953f96b493
docs: fix the typo error for 'Dragging manually' Java example (#20275) 2023-01-23 10:55:00 +01:00
Dmitry Gozman 0cc0d168cd
chore: mark 1.31-next (#20268) 2023-01-20 19:29:14 -08:00
Dmitry Gozman 8d646d1adb
chore: release notes for 1.30 (#20264) 2023-01-20 12:56:48 -08:00
Dmitry Gozman d950f5b6ee
chore: remove toIntersectViewport for the next release (#20232)
Mostly reverts #19901.
2023-01-19 15:04:09 -08:00
Andrey Lushnikov 1b8b20dc25
chore: drop locator.viewportRatio() method (#20131)
As per API review discussion, we'd like to refrain from
exposing this method.
2023-01-19 08:46:45 -08:00
Max Schmitt bddc120bd2
docs: delete showcase.md (#20222)
It was never linked from the sidebar and contains a lot of unmaintained
projects.
2023-01-19 14:09:32 +01:00
Pavel Feldman e08168e16e
chore: temporarily remove project and global setup, store (#20181) 2023-01-18 12:56:03 -08:00
Yury Semikhatsky 0facbe001d
docs: java release notes snippet (#20200) 2023-01-18 12:23:36 -08:00
Debbie O'Brien 17e76db136
docs: update auth examples (#20144)
remove unnecessary step of clicking login
change get by text to button role
change all username and password to strings for consistency
2023-01-18 11:20:22 -08:00
Yury Semikhatsky c36827433d
docs: fix java console message snippet (#20171)
Fixes https://github.com/microsoft/playwright-java/issues/1168
2023-01-17 11:04:43 -08:00
Max Schmitt 341b50fd25
chore: return Promise<any> in {page,context}.unroute (#20135) 2023-01-17 19:14:47 +01:00
Debbie O'Brien 700145e627
docs: improve intro screenshots (#20148) 2023-01-17 13:06:19 +01:00
Debbie O'Brien 57210147f3
docs: improve trace viewer screens (#20147) 2023-01-17 12:42:50 +01:00
Debbie O'Brien ddbd76307d
docs: improve screenshots vscode (#20146) 2023-01-17 12:42:20 +01:00
Simon Siefke 23948c53b7
docs(writing-tests): fix syntax error (#20123)
fixes #20122
2023-01-16 11:16:37 +01:00
Debbie O'Brien e780a5c1ac
docs: improve best practices (#20106) 2023-01-16 10:52:36 +01:00
Pavel Feldman e065d608b6
chore: introduce defineConfig for easier JS typing (#20061)
Fixes https://github.com/microsoft/playwright/issues/19694
2023-01-12 13:12:02 -08:00
Yury Semikhatsky 730a197c80
feat: config.globalScripts (#20062)
Introduce config.globalScripts. Tests from the matching files will run
before all projects. We'll only allow beforeAll/afterAll instead of
tests in such files (next PR).

Global scripts are executed as part of 'Global Scripts' project which is
not present in FullConfig.projects but may be referenced by
corresponding global setup Suites.

Signed-off-by: Yury Semikhatsky <yurys@chromium.org>
Co-authored-by: Dmitry Gozman <dgozman@gmail.com>
2023-01-12 13:02:54 -08:00
Debbie O'Brien fa49803ca0
docs: Best practices (#19634) 2023-01-12 12:45:57 +01:00
Yevhen Laichenkov ed1c4b582f
docs: add missed request fixture in the pre-defined list (#20038) 2023-01-11 14:07:57 -08:00
Yury Semikhatsky 0206d5fb18
docs: update route.fetch example to use new api (#20040) 2023-01-11 09:15:21 -08:00
Mithun Shanbhag 2394debce5
docs(ci): docker container specs go inside jobs (#20020)
Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2023-01-11 10:44:27 +01:00
Max Schmitt 0fe327c21b
chore: return Promise<any> in {page,context}.route (#20005)
Fixes https://github.com/microsoft/playwright/issues/19855
Closes https://github.com/microsoft/playwright/pull/19856
2023-01-10 18:07:17 +01:00
Pavel Feldman 6022a4098f
chore: deprecate page.waitForNavigation, locator.elementHandle (#19977) 2023-01-09 20:04:04 -08:00
Dmitry Gozman 7d2cc06355
docs: add usage sections to Locator methods (#19968) 2023-01-09 13:06:25 -08:00
Yury Semikhatsky a39a97f0ee
chore: setup -> test.projectSetup (#19932)
* Changed `setup` to `test.projectSetup`
* Only `test.projectSetup.only` is supported on the new method
* test.* methods except for before/after/Each/All hooks can be called
inside the project setup files
2023-01-09 11:21:48 -08:00
Max Schmitt e3d615e9f2
docs: add Electron troubleshooting note (#19954)
Fixes https://github.com/microsoft/playwright/issues/19854

Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Pavel Feldman <pavel.feldman@gmail.com>
2023-01-09 18:39:54 +01:00
Vincent G bb275cccb6
docs(test-cli): typo for tests at a specific line (#19908) 2023-01-09 09:14:31 -08:00
Niklas Haag 87b14ea737
docs(writing-tests-js) Fix grammar mistake (#19958) 2023-01-09 17:18:54 +01:00
Andrey Lushnikov 2a49c5e498
feat(expect): introduce expect(locator).toIntersectViewport() (#19901)
This is a new web-first assertion that should be used like this:

```ts
test('should work', async ({ page }) => {
  const locator = page.locator('body');
  // New web-first assertion.
  await expect(locator).toIntersectViewport();
  // The same functionality.
  await expect.poll(() => locator.viewportRatio()).toBeGreaterThan(0);
});
```

Fixes #8740
2023-01-06 16:56:24 -08:00
Dmitry Gozman b376110b77
docs: add proper usage for some test apis (#19925) 2023-01-06 10:26:23 -08:00
Tommaso A 6d64edc090
docs(reporter): added types to Reporter TypeScript example (#19917) 2023-01-06 13:39:17 +01:00
Max Schmitt 2f4b5ea371
docs(java): fix intro examples (#19896)
Signed-off-by: Max Schmitt <max@schmitt.mx>
2023-01-05 20:25:33 +01:00
Boris Osipov 90af7a7ee0
docs(chrome-extensions-js-python.md) add headless testing docs (#19812)
See https://github.com/microsoft/playwright/issues/19233
2023-01-05 11:08:16 -08:00
Emerson Castaneda 9f7b0e4e01
Update writing-tests-java.md sample code (#19894)
Fix code compilation issues reported in
https://github.com/microsoft/playwright-java/issues/1158
2023-01-05 11:05:16 -08:00
Max Schmitt ef877dadfe
docs(test-advanced): add missing browser.close() (#19884)
https://github.com/microsoft/playwright/issues/19822
2023-01-05 11:00:27 -08:00
Max Schmitt ddccb59093
chore: fix Java CLI invocation on Windows (#19895)
For reference: https://stackoverflow.com/a/64300409
2023-01-05 10:55:07 -08:00
Andrey Lushnikov 3883799d68
feat: introduce locator.viewportRatio (#19761)
References #8740
2023-01-05 10:49:32 -08:00
Ori Livni 655d788c8e
docs(ci): fix wrong CircleCI environment vars (#19887) 2023-01-05 11:10:28 +01:00
Dmitry Gozman 599ae30313
chore: update .net generator with deprecated/discouraged (#19843) 2023-01-03 23:03:38 +01:00
Yury Semikhatsky 54c90576c6
docs: clarify what core features are (#19842) 2023-01-03 11:30:38 -08:00
Yusuke Iwaki b2820fccda
docs(python): fix example code of Route.fetch (#19840) 2023-01-03 11:05:09 -08:00
Tim Deschryver 9f27b300f4
docs(test-runners): update test runners for .NET (#19830) 2023-01-03 10:14:00 +01:00
Yury Semikhatsky 137070d889
Revert "chore: hide setup, store, TestProject.setupMatch, storageStat… (#19756)
…eName (#19442)"

This reverts commit 92dd734e04.
2022-12-28 15:39:31 -08:00
Yury Semikhatsky d912cbf115
docs: add instructions on msedge & chrome installation (#19753)
Fixes #18511
2022-12-28 15:13:45 -08:00
Sang Nguyen f88b22d0c0
docs: fix wrong waitForResponse example in Node.js (#19701) 2022-12-27 09:12:43 -08:00
Dave Guarino cb0688bb52
docs(showcase.md): add links to Ruby port (#19712) 2022-12-27 09:11:08 -08:00
Max Schmitt d5881b8d48
docs: test runner first inside Node.js docs (#19659) 2022-12-23 10:57:29 +01:00
Pavel Feldman a248be86ce
docs: http auth via config (#19643)
Fixes https://github.com/microsoft/playwright/issues/19630
2022-12-21 18:19:02 -08:00
Pavel Feldman 675f0eb4a0
chore: report error location for fatal errors (#19610) 2022-12-21 09:36:59 -08:00
Max Schmitt 3555dbd4b4
docs: add 1.29 language port release notes (#19573)
Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Yury Semikhatsky <yurys@chromium.org>
2022-12-20 20:51:21 +01:00
Max Schmitt bb2a2c7331
fix: render discouraged / deprecated types (#19596)
Fixes https://github.com/microsoft/playwright/issues/19591
2022-12-20 16:19:07 +01:00
Jean-François Greffier 6846765a9c
docs: fix docs links (#19510)
Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2022-12-20 13:17:52 +01:00
Vladimir Semenov 467d9f37fc
feat(reporter): Add parallelIndex field to TestResult (#19570) 2022-12-19 14:37:04 -08:00
Pavel Feldman 41174e74a7
chore: replace worker index w/ parallel index in the docs (#19574) 2022-12-19 13:47:05 -08:00
Chen Chen 53ef0d060c
docs(dotnet): fix the nunit and mstest testing examples in intro (#19557) 2022-12-19 16:28:17 +01:00
Yury Semikhatsky b5f908d31f
docs: remove Serializable from Route.*.postData in java (#19532)
We only support String and byte[] and throw otherwise, align the types
with it.
2022-12-16 11:14:29 -08:00
Yury Semikhatsky d01952576d
docs: route.fetch.postData in java (#19527) 2022-12-16 10:14:02 -08:00
Andrey Lushnikov e99323dd90
chore: release notes 1.29 (#19497)
Signed-off-by: Andrey Lushnikov <aslushnikov@gmail.com>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2022-12-16 09:46:40 -08:00
Max Schmitt 1e31afd9d7
docs: fix locator all since version (#19509)
Also a CP candidate.
2022-12-16 18:02:26 +01:00
Max Schmitt ba8a6c4b08
docs: fix HTML snippets (#19507)
Merging unreviewed to unblock docs build.

Main fix is in line 818, others drive-by.
2022-12-16 12:01:33 +01:00
Andrey Lushnikov 0be1fc8559
chore: cut version 1.29 (#19489) 2022-12-15 11:22:35 -08:00
Pavel Feldman 3afd83c8cc
chore: withdraw locator.enumerate (#19484) 2022-12-15 10:13:56 -08:00
Max Schmitt af6e93dfd6
docs(test-cli): document --trace mode (#19474) 2022-12-15 17:14:21 +01:00
Debbie O'Brien 38b8140aab
docs: improve examples in assertions (#19209) 2022-12-15 10:21:35 +01:00
Debbie O'Brien c1a1090eb3
docs: improve locators in fixtures (#19210) 2022-12-15 10:21:08 +01:00
Pavel Feldman 0e2732decf
feat(api): introduce expect().toPass (#19463) 2022-12-14 19:23:13 -08:00
Pavel Feldman 17a0074459
feat(api): introduce Locator.all, enumerate (#19461) 2022-12-14 16:42:50 -08:00
Debbie O'Brien e7b8554342
docs: change listItem to article in locators doc (#19060) 2022-12-14 13:42:52 -08:00
Andrey Lushnikov 8167f8bf54
chore: hide "comparator" option from documentation and types (#19441) 2022-12-14 09:58:19 -08:00
Yury Semikhatsky 92dd734e04
chore: hide setup, store, TestProject.setupMatch, storageStateName (#19442) 2022-12-13 22:48:38 -08:00
Andrey Lushnikov 184ab5b49d
docs: up-to-date linux support (#19440) 2022-12-13 16:19:23 -08:00
Pavel Feldman d1559a0fcc
chore: route.fetch(postData) (#19436) 2022-12-13 14:01:39 -08:00
Dmitry Gozman d02ac9f8db
fix(docs): TestOptions.screenshot typo (#19433) 2022-12-13 12:31:52 -08:00
Pavel Feldman 6cadc56ea3
feat(api): allow getByTestId(regex) (#19419) 2022-12-13 08:43:13 -08:00
Yury Semikhatsky 0cb1e97528
docs: strictSelectors does not affect Locators (#19414)
Fixes https://github.com/microsoft/playwright/issues/19398
2022-12-12 15:09:44 -08:00
Pranav Jain 59118b83f9
feat(android): add support for passing CR args & proxy when launching browser (#19212)
Fixes https://github.com/microsoft/playwright/issues/19211
2022-12-12 16:15:19 +01:00
Patrick Kerschbaum a2172e1799
docs: fix broken link (#19394) 2022-12-12 14:48:44 +01:00
Pavel Feldman 7aa3935dcc
chore: match selected options by both value and label (#19316) 2022-12-07 09:04:32 -08:00
Fernando Garcia Llorente cd4ccdfa29
feat: allow options in automatic screenshots (#19143)
Closes #9983 

Allowing Automatic Screenshots in `PlaywrightTestConfig` to have
`fullPage` & `omitBackground` as optional parameters.
2022-12-07 08:45:33 -08:00
Andrey Lushnikov cac67fb94f
chore: do not use "threshold" option for the ssim-cie94 comparator (#19314) 2022-12-06 17:03:13 -08:00
Yury Semikhatsky beb15bb504
chore: rename setup => setupMatch (#19309) 2022-12-06 14:55:22 -08:00
Yury Semikhatsky 1b3e53697b
chore: TestStorage => TestStore (#19308) 2022-12-06 13:33:43 -08:00
Yury Semikhatsky 405d6267dc
docs: per worker login with auto fixture (#19307) 2022-12-06 13:06:47 -08:00
Yury Semikhatsky 3c1b26b9f1
feat: make storage a global variable (#19283) 2022-12-05 21:37:37 -08:00
Dmitry Gozman e55a2bdf16
docs: rework Selectors to Other Locators (#19244)
- Replace links to `selectors.md` with `locators.md`.
- Remove sections that are covered by Locators docs.
- Restructure the rest of selectors doc, update them in terms of
locators.

Fixes #18992.
2022-12-02 21:48:37 -08:00
Pavel Feldman 9b35ef3b8d
docs: introduce the concept of details (#19242) 2022-12-02 17:35:21 -08:00
Andrey Lushnikov 6d82460a02
feat: implement a new image comparison function (#19166)
This patch implements a new image comparison function, codenamed
"ssim-cie94". The goal of the new comparison function is to cancel out
browser non-determenistic rendering.

To use the new comparison function:

```ts
await expect(page).toHaveScreenshot({
  comparator: 'ssim-cie94',
});
```

As of Nov 30, 2022, we identified the following sources of
non-determenistic rendering for Chromium:
- Anti-aliasing for certain shapes might be different due to the
  way skia rasterizes certain shapes.
- Color blending might be different on `x86` and `aarch64`
architectures.

The new function employs a few heuristics to fight these
differences.

Consider two non-equal image pixels `(r1, g1, b1)` and `(r2, g2, b2)`:
1. If the [CIE94] metric is less then 1.0, then we consider these pixels
   **EQUAL**. (The value `1.0` is the [just-noticeable difference] for
   [CIE94].). Otherwise, proceed to next step.
1. If all the 8 neighbors of the first pixel match its color, or
   if the 8 neighbors of the second pixel match its color, then these
   pixels are **DIFFERENT**. (In case of anti-aliasing, some of the
   direct neighbors have to be blended up or down.) Otherwise, proceed
   to next step.
1. If SSIM in some locality around the different pixels is more than
   0.99, then consider this pixels to be **EQUAL**. Otherwise, mark them
   as **DIFFERENT**. (Local SSIM for anti-aliased pixels turns out to be
   very close to 1.0).

[CIE94]: https://en.wikipedia.org/wiki/Color_difference#CIE94
[just-noticeable difference]:
https://en.wikipedia.org/wiki/Just-noticeable_difference
2022-12-02 15:22:05 -08:00
Yury Semikhatsky e998b6cab9
docs: auth in project setup (#19220) 2022-12-01 16:53:54 -08:00
Max Schmitt 62b28c89b4
docs(assertions): fix wrong toHaveText param description (#19213)
Fixes https://github.com/microsoft/playwright/issues/19202
2022-12-01 09:14:06 -08:00
Pavel d63f2542a2 chore: follow up to mock api doc change 2022-11-30 19:31:30 -08:00
Pavel Feldman 2fd0982372
docs: improve API mocking docs (#19189) 2022-11-30 19:29:14 -08:00
Pavel Feldman f0e8d8f074
feat(api): introduce route.fetch and route.fulfill(json) (#19184) 2022-11-30 17:26:19 -08:00
Max Schmitt 878401ff2b
docs(test-reporters): fix code snippet typos
Fixes #19159
2022-11-30 15:37:31 -08:00
Dmitry Gozman 6721ea4d3a
docs: fix string AriaRole in java/csharp (#19183) 2022-11-30 13:46:33 -08:00
Dmitry Gozman 499324961a
docs: remove Promise.all from examples (#19154)
Replaced with explicit `popupPromise` variable.
2022-11-30 12:36:35 -08:00
Yury Semikhatsky de1fc170b2
docs: TestProject.setup (#19152) 2022-11-30 09:18:47 -08:00
Dmitry Gozman 307a0b6ea7
fix(dotnet): codegen/docs use Name instead of NameString (#19156) 2022-11-29 20:56:18 -08:00
Pavel Feldman 89bdaf2441
chore: rename ScreenshotAssertions to SnapshotAssertions (#19150) 2022-11-29 16:57:03 -08:00
Yury Semikhatsky c9ec8b3e55
docs: clarify what is passed as Test.grep input (#19153)
Fixes https://github.com/microsoft/playwright/issues/18669
2022-11-29 16:03:30 -08:00
Jacob Stevenson b7a49fb371
docs: Improve usage of PublishTestResults for Azure Pipelines (#18241) 2022-11-29 13:02:30 -08:00
Tom Sparrow 90e3194482
docs(debug.md): clarify what slowMo number means (#18788) 2022-11-29 12:54:18 -08:00
Devin Beliveau 707cb1a0d5
docs: correct CircleCI brand name (#18988) 2022-11-29 12:52:07 -08:00
Shubham Kanodia 3d804ff7cd
chore: rewrite error message for missing snapshot (#19104) 2022-11-29 12:51:15 -08:00
Brian Zelip 7a68e79b7f
docs(js): add step to the cli install command overview (#19089) 2022-11-28 20:02:55 -08:00
Simon Legner 43cde2db10
docs(locator): fix #locate-by-test-id link (#19095) 2022-11-28 20:00:30 -08:00
Dmitry Gozman 65b0fb055d
docs: note assertion methods that only work with playwright test runner (#19116)
Fixes #18963.
2022-11-28 10:32:48 -08:00
Dmitry Gozman bd07a63683
docs: highlight printsToStdio in reporter reference (#19118)
Fixes #18945.
2022-11-28 10:32:01 -08:00
Simon Legner 9e91ca353c
docs(release-notes): YouTube video for version 1.28 (#19099) 2022-11-27 22:51:03 -10:00
Pavel Feldman be2139f0ac
docs: split assertions list into langs (#19039) 2022-11-24 08:25:24 -08:00
Max Schmitt 30debb5110
docs(python): expand assertion List types (#18975)
The following was before:

```txt
typing.Union[
    typing.List[typing.Union[typing.Pattern[str], str]],
    typing.Pattern[str],
    str,
]
```

but it should be:

```txt
typing.Union[
    typing.List[typing.Pattern[str]],
    typing.List[str],
    typing.List[typing.Union[typing.Pattern[str], str]],
    typing.Pattern[str],
    str,
]
```

Otherwise mypy yells at us.

See https://github.com/microsoft/playwright-python/issues/1524
2022-11-23 11:32:16 -10:00
Pavel Feldman f9a32e0927
chore: follow up to deprecation changes (#19025) 2022-11-23 12:32:14 -08:00
Pavel Feldman f97dcd4c79
docs: annotate deprecated methods (#19005) 2022-11-23 08:40:47 -08:00
ffluk3 e2624979e6
Fix timeout documentation (#18925) 2022-11-21 15:35:35 -08:00
Eduardo Vargas Torres 490ae796f3
docs (test-typescript-js.md): clarify TS ESM config (#18971)
Signed-off-by: Eduardo Vargas Torres <evargast@adobe.com>
2022-11-21 15:31:37 -08:00
Max Schmitt 6a5552ba24
chore: drop Ubuntu 18.04 support (#18924) 2022-11-21 11:23:45 -10:00
Dmitry Gozman d6ab1a90bf
docs: fix typos in some snippets (#18966)
Fixes #18898.
2022-11-21 10:47:38 -08:00
Pavel Feldman 620e8547d4
chore: generate usage: sections based on snippets (#18965) 2022-11-21 10:40:21 -08:00
Pavel Feldman 3fb4b3bbf9
chore: normalize api markdown (#18942) 2022-11-21 09:30:32 -08:00
Max Schmitt c2e3704f86
docs(dotnet): wrong AddInitScriptAsync snippet (#18893)
Fixes https://github.com/microsoft/playwright-dotnet/issues/2399
2022-11-17 10:58:49 -10:00
Max Schmitt 3ed9dab1c9
docs(locator): code snippet fixes (#18884)
Follow-up on https://github.com/microsoft/playwright/pull/18839
2022-11-17 10:41:25 -08:00
Pavel Feldman f7b269d9c6
docs: brush up writing tests section (#18861) 2022-11-16 19:48:20 -08:00
Eduard Bardají Puig 10b8a83b45
docs(parameterize): fix code snippet (#18848) 2022-11-16 11:44:45 -10:00
Christian Clauss a7f205bf4d
docs(ci): upgrade GitHub Actions (#18845) 2022-11-16 11:42:04 -10:00
Yury Semikhatsky 5fcd8839dc
docs: Java, .NET, Python release notes 1.28 (#18854) 2022-11-16 13:19:20 -08:00
Yury Semikhatsky 05fb3e6de8
Revert "chore: hide TestProject.setup and TestInfo.storage (#18800)" (#18836)
Now that the patch has been cherry-picked to the release branch
reverting it on main.

This reverts commit 6deba5dc21.
2022-11-16 11:23:10 -08:00
Pavel Feldman 7c65b5d1f5
chore: render html cards for locators.md (#18839) 2022-11-16 09:54:40 -08:00
Debbie O'Brien 402b2d499e
docs: update vscode doc (#18809) 2022-11-16 08:12:26 +01:00
Dmitry Gozman 0387d96cd5
chore: multiply overloaded options in csharp (#18818)
This way we'll get the same treatment in docs generator as well as
dotnet api generator.

This also adds non-suffixed aliases for string options, e.g. `Name` in
addition to `NameString` and `NameRegex`.

Fixes #18407.
2022-11-15 15:46:54 -08:00
Pavel Feldman 210a57ea3b
docs: remove images from locators.md (#18832) 2022-11-15 13:13:16 -08:00
Andrey Lushnikov 250bc9fb2f
doc: version 1.28 release notes (#18802) 2022-11-15 11:40:35 -08:00
Yury Semikhatsky 6deba5dc21
chore: hide TestProject.setup and TestInfo.storage (#18800) 2022-11-14 17:03:01 -08:00
Dmitry Gozman 1b0a8122ba
chore: allow py code blocks for python (#18799)
Turns out, we have some snippets that use `py` instead of `python`.
2022-11-14 14:50:01 -08:00
Debbie O'Brien 25605c616c
Selectors quick fix (#18742) 2022-11-14 15:23:25 +01:00
Dmitry Gozman a7b2b04588
fix(getByRole): name and exact (#18719)
Following the `getByText()` and other methods:

- By default, matching is substring and case-insensitive. Before, it was
only case-insensitive, but not substring.
- With new option `exact: true`, matching is full string and
case-sensitive.
- Matching always normalizes whitespace.
- Codegen generates `exact: false` by default.
- `internal:role` treats `[name="foo"i]` as non-exact match.

Various fixes:
- Updated `getByRole` docs to match the reality.
- Locator generator edge cases.
2022-11-11 15:58:36 -08:00
Andrey Lushnikov bc78db07df
chore: cut 1.28 branch (#18746) 2022-11-11 15:30:15 -08:00
Andrey Lushnikov 251cc9e229
chore: fix docs (#18751) 2022-11-11 13:44:40 -08:00
Debbie O'Brien 2e84c63f0d
docs: update locators in getting started (#18738) 2022-11-11 16:24:26 +01:00
Debbie O'Brien ad5fe28416
docs: improve locators examples and flow (#18548) 2022-11-11 16:23:00 +01:00
Andrey Lushnikov f3a99fdd69
chore: address API review comments for the snapshotPathTemplate (#18716)
This patch:
- updates documentation to lead users from `TestConfig.snapshotDir` and
  `testInfo.snapshotSuffix` to `TestConfig.snapshotPathTemplate` as a
  better and more flexible alternative.
- drops `{snapshotSuffix}` from documentation
- stops using `snapshotSuffix = ''` in our own tests and switches us
  to the `snapshotPathTemplate`.
- adds `{testName}` token.
2022-11-10 17:23:57 -08:00
Chris Alley 1ec614bfc4
docs: fix grammar within class test API documentation (#18627) 2022-11-10 15:53:48 -08:00
Dmitry Gozman 194abc35cd
Revert #18561 "feat(test runner): test.reset() to reset options to default/config value" (#18704)
This reverts commit 6fef227f43.

Not shipping in 1.28.
2022-11-10 14:45:05 -08:00
Dmitry Gozman 6d456d30dc
docs: improve test.describe.configure() (#18705) 2022-11-10 12:29:38 -08:00
Dmitry Gozman 7c80b77c57
feat(clear): remove clear() methods from all classes except Locator (#18703)
The preferred way is to use the locator, so we should not encourage the
use of `ElementHandle` or `Page` in the new APIs.
2022-11-10 12:29:14 -08:00
Andrey Lushnikov f52fa4ceba
chore(snapshotPathTemplate): address review comments (#18702) 2022-11-10 11:37:41 -08:00
Dante Monaldo e6a1bdffee
docs(auth): fix session storage examples (#18686)
Co-authored-by: Dante <dante@usebasis.co>
2022-11-10 09:43:42 -08:00
Andrey Lushnikov 6d491f928d
feat(playwright-test): introduce snapshotPathTemplate configuration (#18568)
This configuration option allows to set a string with template
values for precise control over snapshot path location.

An example of `snapshotPathTemplate` usage:

```ts
// playwright.config.ts
// Notice the `testDir` configuration!
export default {
  testDir: './tests',
  snapshotPathTemplate: './__screenshots__/{platform}/{projectName}/{testFilePath}/{arg}{ext}',
}
```

Currently supported "magic tokens" inside the `snapshotPathTemplate`
are:

- `{testDir}` - project's `testDir`
- `{snapshotDir}` - project's `snapshotDir`
- `{platform}` - `process.platform`
- `{projectName}` - Project's sanitized name
- `{testFileDir}` - Directories in relative path from `testDir` to test
  file path (e.g. `page/` in the example below)
- `{testFileName}` - Test file name (with extension) (e.g.
  `page-click.spec.ts` in the example below)
- `{testFilePath}` - Relative path from `testDir` to test file path
  (e.g. `page/page-click.spec.ts` in the example below)
- `{ext}` - snapshot extension (with dots)
- `{arg}` - joined snapshot name parts, without extension (e.g.
`foo/bar/baz` in the example below)
- `{snapshotSuffix}` - `testInfo.snapshotSuffix` value.

Consider the following file structure:

```
playwright.config.ts
tests/
└── page/
    └── page-click.spec.ts
```

The following `page-click.spec.ts`:

```ts
// page-click.spec.ts
import { test, expect } from '@playwright/test';

test('should work', async ({ page }) => {
  await expect(page).toHaveScreenshot(['foo', 'bar', 'baz.png']);
});
```

Fixes #7792
2022-11-09 15:29:07 -08:00
Andrey Lushnikov 9bcb28f25a
Revert "feat: send SIGTERM to webserver before SIGKILL'ing it. (#18220)" (#18661)
This reverts commit c63a0b536d.

Reason: https://github.com/microsoft/playwright/pull/18564
2022-11-09 09:18:33 -08:00
Max Schmitt 06353e9905
docs(trace-viewer): fix broken examples (#18654)
Fixes https://github.com/microsoft/playwright-python/issues/1616
2022-11-08 14:22:14 -08:00
Yury Semikhatsky d5494edf71
feat(runner): TestOptions.storageStateName (#18587) 2022-11-07 16:27:38 -08:00
Max Schmitt 48d7bfc55f
docs: delete old auth + pom guides (#18615) 2022-11-07 15:31:42 -08:00
Kazuya Takei 05471df8bb
docs(python): remove not-needed semicolons from code snippets (#18589) 2022-11-07 08:28:07 -08:00
Yury Semikhatsky 25dc0bfacb
feat(runner): change storage fixture to TestInfo.storage() (#18584) 2022-11-04 14:28:25 -07:00
Dmitry Gozman 6fef227f43
feat(test runner): test.reset() to reset options to default/config value (#18561) 2022-11-04 09:03:29 -07:00
Max Schmitt 245260b365
docs(python): Page.emulateMedia.media "null" value follow-up (#18555)
Follow-up of 91f7e3963d.
2022-11-03 17:50:32 -07:00
Xiaoxing Ye 9338355e47
feat(testinfo): add name to attachment output name (#18440)
Per discussion in #12950, adding sanitized name to the output filename
prefix. This can make debugging easier, and the filename structure more
human friendly.
2022-11-03 13:54:51 -07:00
Max Schmitt 91f7e3963d
docs(python): have enum value to reset emulated media (#18550) 2022-11-03 12:38:02 -07:00
Yury Semikhatsky 45aa82242d
feat(runner): storage fixture (#18522) 2022-11-02 20:22:35 -07:00
Dmitry Gozman 8292398692
docs: support custom hrefs for api links (#18514) 2022-11-02 13:35:51 -07:00
Yury Semikhatsky 1d2fc1e963
feat(runner): project.setup (#18486) 2022-11-01 23:44:30 -07:00
Andrey Lushnikov a56460acb2
docs: add note to docs about WebInspector (#18483) 2022-11-01 14:01:02 -07:00
Debbie O'Brien 84aa67a7fc
docs: add release video (#18459) 2022-10-31 22:38:43 +01:00
Yury Semikhatsky 7337dd4e28
chore: revert project.{stage,run} (#18462) 2022-10-31 14:04:24 -07:00
jaktestowac.pl 9ad18b9e57
docs(ci): update ci example to avoid warnings (#18405)
Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2022-10-31 12:19:10 -07:00
Anner Visser 5f309ec49a
docs(docker): remove array around seccomp profile (#18457) 2022-10-31 12:17:10 -07:00
Tim Deschryver cb1dcccbe6
docs(nodejs): extend geolocation context examples (#17587) 2022-10-31 09:39:44 -07:00
Pavel Feldman a7f5f2d7a1
chore: allow not overriding media when creating context (#18413) 2022-10-31 09:09:52 -07:00
Denis LE ce7fc1b9f3
docs(locators): fix missing input id (#18386)
Signed-off-by: Denis LE <ledenis@users.noreply.github.com>
Signed-off-by: Max Schmitt <max@schmitt.mx>
Co-authored-by: Max Schmitt <max@schmitt.mx>
2022-10-30 21:05:24 -07:00
Debbie O'Brien 37cd573652
docs: add missing locators + improvements (#18404) 2022-10-28 14:49:25 -07:00
Max Schmitt 445404abb7
docs: fix dotnet RegisterAsync/python jshandle example (#18408)
Fixes https://github.com/microsoft/playwright-dotnet/issues/2359
Fixes https://github.com/microsoft/playwright-python/issues/1607
2022-10-28 09:58:54 -07:00
Debbie O'Brien 8e9540b7c1
docs: remove selectors from getting started (#18403) 2022-10-28 08:54:21 -07:00
Dmitry Gozman 2d3b2a0768
feat(test runner): test.describe.configure({ retries, timeout }) (#18388)
References #10825.
2022-10-27 15:53:27 -07:00
Dmitry Gozman c4404ea98f
docs: add examples and clarifications to getByText (#18380)
Also be more explicit about normalizing whitespace, event with exact
match.

Fixes #17831.
2022-10-27 10:27:18 -07:00
Dmitry Gozman eb1c92630e
docs: update locators doc to use new APIs (#18352) 2022-10-26 15:30:22 -07:00
Debbie O'Brien d4bab139b2
docs: Codegen new screenshots (#18347) 2022-10-26 20:49:02 +02:00
Debbie O'Brien f6e642e1fa
docs: add more content to getting started vscode (#18338) 2022-10-26 20:18:16 +02:00
Max Schmitt e25537f941
feat(android): add AndroidDevice.close event (#18306) 2022-10-25 18:18:14 -07:00
Jean-François Greffier 0fe1998c72
feat(api): add clear() (#18296)
Add `clear()` method as a convenience shortcut for `fill('')`.
Implemented for AndroidDevice, ElementHandle, Frame, Locator and Page.

Fixes https://github.com/microsoft/playwright/issues/14041
2022-10-25 12:56:11 -07:00
Dmitry Gozman 921a960921
docs: fix library-js (#18314)
Fixes #18145.
2022-10-25 08:50:28 -07:00
Dmitry Gozman 329b3eadb4
feat: locator.blur() (#18303)
Note this is only available on Locator. Fixes #10724.
2022-10-25 06:10:40 -07:00
Debbie O'Brien 6c3f3068b6
docs: explanations for test isolation (#17582) 2022-10-25 08:01:47 +02:00
Max Schmitt 805312b722
feat(android): add Android.{launchServer,connect} (#18263)
Fixes https://github.com/microsoft/playwright/issues/17538
2022-10-24 17:23:11 -07:00
Pavel Feldman ab78865a8d
chore: render steps in list reporter (#18269) 2022-10-24 15:54:53 -07:00
Max Schmitt cfad84cbca
docs(test-cli): remove --ignore-snapshots alias (#18295)
Fixes https://github.com/microsoft/playwright/issues/18291

Signed-off-by: Max Schmitt <max@schmitt.mx>
2022-10-24 10:49:58 -07:00
Dmitry Gozman 98215b4d74
docs: mention VSCode extension in debugging doc (#18261) 2022-10-21 16:29:59 -07:00
Max Schmitt a1d37e9169
docs: add new java intro (#17695)
Fixes https://github.com/microsoft/playwright/issues/17479
2022-10-21 09:52:36 -07:00
Andrey Lushnikov c63a0b536d
feat: send SIGTERM to webserver before SIGKILL'ing it. (#18220)
We now will send `SIGTERM` to the webserver and wait for the `timeout`
before sending `SIGKILL` to it.

Fixes #18209
2022-10-21 08:55:06 -07:00
Sean Killeen 7ae447ea0f
docs: fix typos (#17919) 2022-10-20 13:46:37 -07:00
AlenPaulVarghese 696f6f029a
docs: fixed a typo, in the documentation (#18218) 2022-10-20 13:35:17 -07:00
Pavel Feldman 05678c9986
docs: add custom test id attribute snippet (#18210)
Fixes https://github.com/microsoft/playwright/issues/18203
2022-10-20 10:54:57 -07:00
smacpherson64 2d120a3955
docs(puppeteer): fix broken waitForLoadState code snippet (#18212) 2022-10-20 10:50:41 -07:00
sand4rt 4ed2a01d9c
core(ct): import paths (#18131) 2022-10-19 19:41:21 -07:00
Dmitry Gozman 852a5c234b
feat(install): connection timeout (#18161)
- `PLAYWRIGHT_DOWNLOAD_CONNECTION_TIMEOUT` for custom timeout.
- Bumped default timeout from 10s to 30s.
- Inlined `download.ts` to avoid extra plumbing.
- Removed optional arguments - we always pass them.
- Updated installation docs.

Fixes #18156.
2022-10-19 13:06:35 -07:00
Yury Semikhatsky 11eb719d13
feat(runner): project run: "always" (#18160)
Projects marked with `run: 'always'` are non shard-able and run after
failures.
2022-10-18 17:18:45 -07:00
Pavel Feldman 739b64a09a
chore: render typed locators in the recorder (#18162) 2022-10-18 16:39:58 -07:00
Yury Semikhatsky 734dd5d171
docs: update languages section (#18130) 2022-10-17 14:06:32 -07:00
Debbie O'Brien 2efa96a882
docs: update docs to show role selectors (#18063) 2022-10-14 16:55:52 +02:00
Max Schmitt a60073d664
fix(generator): .NET getByRole w/ name (#18060) 2022-10-13 08:23:43 -07:00
Yury Semikhatsky 08a3a269cd
feat(runner): project.canShard (#18037) 2022-10-12 14:34:22 -07:00
Max Schmitt e986e88c55
docs: fix wrong getByLabelText example (#18036) 2022-10-12 13:02:45 -07:00
Yury Semikhatsky 3b8f63d703
feat(runner): project.stopOnFailure (#18009) 2022-10-11 17:04:01 -07:00
Yury Semikhatsky 3592269caf
feat(runner): project.stage (#17971) 2022-10-10 17:56:18 -07:00
Max Schmitt 815277c546
docs(pytest): by default it runs on chromium (#17967)
Fixes https://github.com/microsoft/playwright-pytest/issues/132
2022-10-10 22:42:50 +03:00
Álvaro Martínez d6384a12f5
docs(release-notes): add missing reference to Page.getByTestId in 1.27 release notes (#17942)
1.27 release notes don't mention the new `Page.getByTestId` method
alongside the other added methods (`getByRole`, `getByLabelText` etc.)

This PR adds it to the corresponding release notes.

I'm not 100% sure this is the way to do it, I assume there's some
automation going on to update the documentation website, let me know if
it needs t be done differently.
2022-10-10 22:18:15 +03:00
John Hawkinson a62a67fba3
docs(library) fix js example (#17933)
Co-authored-by: Max Schmitt <max@schmitt.mx>
2022-10-10 21:54:17 +03:00
Oliver Sand 6b01df6d92
fix: fix typo in treeitem role typing (#17952) 2022-10-10 20:57:55 +03:00
sand4rt 842dec334d
docs(ct): general improvements (#17923) 2022-10-08 18:56:54 +03:00
Gustav Ahlberg aad0fd9bdf
docs(class-testconfig): update since version for fullyParallel (#17916) 2022-10-08 09:03:01 +03:00
Yury Semikhatsky 946994ca92
docs: AriaRole is enum (#17918) 2022-10-08 09:01:14 +03:00
Yury Semikhatsky 639b28db3b
fix: noWaitAfter option for hover (#17856)
Fixes https://github.com/microsoft/playwright/issues/17833
2022-10-07 12:43:48 -07:00
Yury Semikhatsky b140b29df0
docs: clarify routeFromHAR.update semantics (#17887) 2022-10-07 11:27:25 -07:00
Dmitry Gozman df4498e7ee
docs: mention that exact option is ignored for regex (#17912) 2022-10-07 10:19:13 -07:00
Debbie O'Brien c8487624dc
docs: improve trace viewer + add video (#17907) 2022-10-07 09:51:16 -07:00
Dmitry Gozman 43208da3f8
docs: v1.27 release notes for python, java and dotnet (#17886) 2022-10-06 12:51:56 -07:00
Pavel Feldman eb4baf76bf
feat(api): make aria roles an enum (#17885) 2022-10-06 11:34:22 -07:00
sand4rt 8d078cc87a
docs(ct): solid and typo (#17769) 2022-10-06 08:25:16 -07:00
Dmitry Gozman ed6ecbca2a
chore: cut v1.27.0 (#17859) 2022-10-05 15:30:35 -07:00
Dmitry Gozman cdeb9e3066
docs: release notes for v1.27 (#17858) 2022-10-05 14:24:24 -07:00
Dmitry Gozman 6750a02506
fix(api): hide TestConfig.groups (#17853)
Also fix types for `FullConfig.configFile`.
2022-10-05 14:24:14 -07:00
Dmitry Gozman 30179d4d78
fix(tsconfig): remove TS_NODE envs, update docs (#17847)
References #17469.
2022-10-05 12:51:12 -07:00
Pavel Feldman 8810b55504
feat(api): shorted getByLabel, getByPlaceholder (#17816) 2022-10-04 10:29:26 -07:00
Justin Kat e2b5fc4f88
docs(chrome-extensions): update test fixture grammar (#17770) 2022-10-04 12:18:01 +02:00
arukiidou a9807ce93d
docs(test-reporters): add third-party ReportPortal reporter (#17762) 2022-10-04 12:14:41 +02:00
maple 04cd31569a
docs(puppeteer): fix unbalanced parentheses (#17778) 2022-10-04 12:12:38 +02:00
Dmitry Gozman b07690f408
docs: use getBy... in documentation (#17795) 2022-10-03 17:02:46 -07:00
Dmitry Gozman 57cde6e671
docs: fix locators guide (#17781)
Tabs, as in python sync vs async, cannot be placed inside a list item -
docasaurus doesn't like that.

Reverting "lists" section to fix it.
2022-10-03 12:24:26 -07:00
Dmitry Gozman be150796f4
docs: improve locators guide (#17596)
Fixes #17134.
2022-09-30 11:14:13 -07:00
Max Schmitt 0e740f85ea
docs(ct): fix broken examples (#17737) 2022-09-30 16:30:32 +02:00
Han Yeong-woo ce2ded1f7e
docs(assertions): fix wrong link (#17733) 2022-09-30 11:07:14 +02:00
Pavel Feldman bfb8a43ece
feat(api): all getByTitle, getByAltText (#17724) 2022-09-29 21:45:44 -07:00
Pavel Feldman 6e839ff404
fix(test): remove component.get usages (#17723) 2022-09-29 20:18:26 -07:00
Pavel Feldman 083fb4401c
feat(api): add getByPlaceholderText (#17722) 2022-09-29 18:12:49 -07:00
Pavel Feldman 68030e563d
docs: update ct faq (#17717)
Co-authored-by: Ross Wollman <rwoll@users.noreply.github.com>
2022-09-29 15:09:27 -07:00
Andrey Lushnikov d897407833
chore: hide docker integration behind the curtain (#17715)
This is not ready for the prime time yet.
2022-09-29 14:22:09 -07:00
Pavel Feldman a97deb1600
chore: hide reporter project id (#17710) 2022-09-29 12:51:06 -07:00
Pavel Feldman b4ee84fb0c
chore(api): remove locator.get() (#17709) 2022-09-29 12:50:52 -07:00
Pavel Feldman e3a2316013
feat(api): add getByLabelText (#17684) 2022-09-29 11:06:58 -07:00
Debbie O'Brien 00a2d146d3
docs: remove toc and api references from network doc (#17628) 2022-09-29 15:42:01 +02:00
Yury Semikhatsky 9f17ee6871
feat: group filter (#17646) 2022-09-28 18:45:01 -07:00
Dmitry Gozman 6fc7d20e35
docs: add drag&drop section to Actions guide (#17673)
References #17153.
2022-09-28 14:36:27 -07:00
Pavel Feldman d8f67eb75d
feat(api): introduce getByTestId (#17645) 2022-09-27 21:06:07 -07:00
Pavel Feldman d9a28bd244
feat(api): introduce get/getByText/getByRole (#17577) 2022-09-27 16:13:56 -07:00
sand4rt 45b3476c8c
docs(ct): solid (#17568) 2022-09-27 13:26:29 -07:00
Pavel Feldman bfd38bf7df
chore: introduce md templates (#17632) 2022-09-27 10:29:34 -07:00
Debbie O'Brien 6fe551e6ac
docs: remove toc (#17626) 2022-09-27 08:45:32 -07:00
Debbie O'Brien cfcf1dfb4f
docs: remove toc and api ref from navigations doc (#17627) 2022-09-27 08:45:12 -07:00
Debbie O'Brien 1e286ffdc7
docs: accessibility remove toc, improve disclaimer (#17629) 2022-09-27 08:38:10 -07:00
Debbie O'Brien 0169673ad7
docs: remove inline toc (#17630) 2022-09-27 08:37:32 -07:00
Max Schmitt b9e126b3e6
docs: add initial WebView2 guide (#17190) 2022-09-26 22:32:42 +02:00
Yusuke Iwaki f5d7089819
fix: accept post data params for request.get and request.head (#17566) 2022-09-26 09:28:07 -07:00
Andrey Lushnikov ec40e49978
feat: expose configuration for HTML report serving. (#17560)
Fixes #16667
2022-09-25 20:36:38 -07:00
Yury Semikhatsky 10d7c60abf
feat(runner): project execution schedule (#17548) 2022-09-23 20:01:27 -07:00
depa panjie purnama 080cf29191
docs: fix failed POM test example (#17552) 2022-09-23 19:15:37 +02:00