Commit graph

818 commits

Author SHA1 Message Date
Dmitry Gozman 19f739dec8
docs: update fixtures doc (#10426)
- Introduction
  - Built-in fixtures
  - Without fixtures
  - With fixtures
- Creating a fixture
- Using a fixture
- Overriding fixtures
- Worker-scoped fixtures
- Automatic fixtures
- Fixtures-options
2021-11-18 21:35:21 -08:00
Dmitry Gozman d9f849fb14
feat(test runner): replace declare/define with "options" (#10293)
1. Fixtures defined in test.extend() can now have `{ option: true }` configuration that makes them overridable in the config. Options support all other properties of fixtures - value/function, scope, auto.
```
const test = base.extend<MyOptions>({
  foo: ['default', { option: true }],
});
```

2. test.declare() and project.define are removed.

3. project.use applies overrides to default option values and nothing else. Any test.extend() and test.use() calls take priority over config options.

Required user changes: if someone used to define fixture options with test.extend(), overriding them in config will stop working. The solution is to add `{ option: true }`.

```
// Old code
export const test = base.extend<{ myOption: number, myFixture: number }>({
  myOption: 123,
  myFixture: ({ myOption }, use) => use(2 * myOption),
});

// New code
export const test = base.extend<{ myOption: number, myFixture: number }>({
  myOption: [123, { option: true }],
  myFixture: ({ myOption }, use) => use(2 * myOption),
});
```
2021-11-18 15:45:52 -08:00
Nav-2d 82edd1f4b2
docs/test-configuration: Update code snippet (#10355) 2021-11-18 15:38:18 -08:00
Andrey Lushnikov 5eba6d538f
docs: land 1.17 release notes (#10425) 2021-11-18 15:08:49 -08:00
Max Schmitt 0781d0303b
docs(python): enable web-first assertions (#10390) 2021-11-18 00:46:30 +01:00
Dmitry Gozman 6e2bc890a6
docs: add links from annotations to respective methods (#10379) 2021-11-17 11:03:30 -08:00
Yury Semikhatsky 565ac910e7
docs(api): expose request API in java (#10331) 2021-11-15 14:54:07 -08:00
Yury Semikhatsky c5cb73003f
docs: OR for css and xpath selectors (#10285) 2021-11-15 13:54:12 -08:00
browse 5d4ec1d512
docs(python): fix incorrect snippet syntax (#10314) 2021-11-15 11:20:46 +01:00
Yevhen Laichenkov 724dc2ff2f
docs(test-parameterize): fix snippet typo (#10280) 2021-11-12 07:00:41 -08:00
Nav-2d 58b4052378
docs/test-config: add github, html reporter (#10234) 2021-11-12 06:50:56 -08:00
Max Schmitt d97fe4e2af
docs(test-parameterize): fixed snippet typo (#10276) 2021-11-12 05:50:45 -08:00
Max Schmitt 24cfcf867e
chore: create-playwright config nits & test-runner intro docs (#10253) 2021-11-11 22:45:07 +01:00
Dmitry Gozman 9622704a8a
fix(test runner): update TestInfo.duration before running afterEach hooks (#10228) 2021-11-10 16:02:27 -08:00
Pavel Feldman 1e38ec5fa4
docs(element-handle): discourage the element handle use (#10220) 2021-11-10 11:30:25 -08:00
Pavel Feldman 4e90eb9406
api(frame-locator): allow nth, first, last (#10195) 2021-11-09 14:14:20 -08:00
Yury Semikhatsky c30447216d
docs(fetch): typo in comment (#10160) 2021-11-09 14:00:58 -08:00
Dmitry Gozman 7bb38d2ac8
docs: use desktop devices in sample configs (#10197) 2021-11-09 13:19:21 -08:00
Yury Semikhatsky 031ceb3553
docs(java): assertion examples (#10194) 2021-11-09 12:44:02 -08:00
Pavel Feldman 1bf7f6d90d
docs: expand core-concepts and multi-age (#10161) 2021-11-09 07:42:04 -08:00
Max Schmitt 1a7fb912e4
docs(python): enable request API (#10179) 2021-11-09 14:04:34 +01:00
Dmitry Gozman 5c9dcffd67
docs(intro): rework js intro (#10157)
- Educate on the config file right away.
- Switch from `--browser` to `--project`.
- Update configuration sections.
2021-11-08 17:50:48 -08:00
Pavel Feldman 7b64161a37
feat(test-runner): allow specifying fine-grained trace options (#10147) 2021-11-08 15:39:58 -08:00
Dmitry Gozman 0a104bc500
docs: clarify that slow tests are about files (#10134) 2021-11-08 12:54:18 -08:00
Yury Semikhatsky ac25a67140
docs(java): assertion docs fixes (#10144) 2021-11-08 11:31:11 -08:00
Dmitry Gozman 9a7b4b745b
docs: Suite.project is a method, not a property (#10135) 2021-11-08 10:08:46 -08:00
Pavel Feldman 4553d76fce
api(frame-locator): introduce frame locators (#10102) 2021-11-08 09:58:24 -08:00
Yury Semikhatsky 4c53824235
docs: committed navigation (#10023) 2021-11-03 15:26:25 -07:00
Yury Semikhatsky bce9a8187d
fix(fetch): post data for delete request (#10019) 2021-11-03 13:26:15 -07:00
Max Schmitt bde5c2590e docs: fix minor release note typos 2021-11-03 20:51:47 +01:00
Dmitry Gozman 9cebe60831
feat(reporters): augment non-stdio reporters with dot/line (#10003) 2021-11-03 08:25:16 -07:00
Yury Semikhatsky 64a2be0e43
docs(java): message loop, Thread.sleep vs waitForTimeot (#9978) 2021-11-02 10:17:35 -07:00
Max Schmitt bedb817a00
docs(test-runner): worker fixtures only in before/after-All (#9967) 2021-11-02 16:51:41 +01:00
Max Schmitt b8b4f904b2
docs(auth): fix session storage restore snippets (#9970) 2021-11-02 16:51:22 +01:00
Nick Partridge a51ac39275
feat: add snapshotDir to set base snapshot directory (#9260) 2021-11-02 08:02:49 -07:00
Pavel Feldman 56ca3a18f5
feat(trace-viewer): show test name (#9957) 2021-11-01 21:23:35 -07:00
Pavel Feldman 85497c5509
feat(tracing): allow including source files in traces (#9946) 2021-11-01 19:57:29 -07:00
Yury Semikhatsky 13cc266b37
feat: add "commit" to possible waitUntil options (#9892) 2021-11-01 17:12:19 -07:00
Dmitry Gozman 4f1027bdd0
feat(test runner): introduce TestInfo.parallelIndex (#9762)
This is a worker number between `0` and `workers - 1` that
does not change after worker process restart.
2021-11-01 10:37:34 -07:00
Darío Kondratiuk 498894280b
docs(page): Document Page.reload (#9926) 2021-11-01 18:27:03 +01:00
Pavel Feldman d6adff7792
fix(html): include html into the reporter types (#9907) 2021-10-31 11:06:28 -07:00
Pavel Feldman 8991bbde33
feat(html): live filtering, opt-out from auto-open (#9889) 2021-10-29 16:24:08 -07:00
Dmitry Gozman 49337890d2
docs: improve documentation for assertions and test config (#9890) 2021-10-29 15:25:52 -07:00
Yury Semikhatsky 34e55007d0
docs: clarify how to import assertions (#9868) 2021-10-29 08:33:07 -07:00
Yury Semikhatsky 759e1b6bda
docs: fix list formatting (#9857) 2021-10-28 11:06:41 -07:00
Kenneth Lum a72930a7bb
docs: add the general rule to expect the opposite of the matchers (#9772) 2021-10-28 08:35:35 -07:00
Max Schmitt 885cd67f3d
docs(python): move browser_context_args fixture back to session scope (#9711) 2021-10-28 11:53:23 +02:00
Dmitry Gozman fac5da9517
docs: update console event snippet (#9800)
This avoids the confusion where arguments are printed
asynchronously, interleaved with other console messages.
2021-10-26 14:40:28 -07:00
Dmitry Gozman 676e72c8e0
docs(proxy): note that browser-wide proxy is only required for Cr+Win (#9767) 2021-10-25 16:32:09 -07:00
Yury Semikhatsky ada7f4be23
docs(api): add assertThat aliases for java (#9761) 2021-10-25 12:03:24 -07:00
Yury Semikhatsky 9eadbf9b81
docs(api): add locator assertions for java (#9723) 2021-10-22 16:56:58 -07:00
Dmitry Gozman 23aa0be15b
docs: update afterEach docs with an example (#9727)
Also add a test for TestInfo.status in afterEach.
2021-10-22 16:32:22 -07:00
Yury Semikhatsky e7b4c181c7
docs(api): add assertions API for java (#9660) 2021-10-21 17:44:17 -07:00
Yury Semikhatsky 2ad2f53482
docs(fetch): merge UI test examples into API testing guide (#9684) 2021-10-21 11:44:06 -07:00
Max Schmitt dd5364e445
feat(create-playwright): add option to add examples (#8963) 2021-10-21 20:21:50 +02:00
Andrey Lushnikov df188d5876
docs: release notes for other ports (#9681) 2021-10-21 11:13:19 -07:00
Andrey Lushnikov 0a7e1c90eb
chore: add release notes for 1.16 (#9680) 2021-10-21 10:39:41 -07:00
Andrey Lushnikov 7626e881ac
docs: move api testing to test sidebar (#9670) 2021-10-20 18:38:01 -07:00
Yury Semikhatsky ddb70a6d35
docs(expect): default timeout (#9658) 2021-10-20 12:06:02 -07:00
Dmitry Gozman fb421e0a65
feat(github reporter): update docs, strip ansi escapes (#9640) 2021-10-20 07:56:03 -07:00
Yury Semikhatsky 2a2a3d2ed9
docs(expect): group locator methods, remove extra > (#9625) 2021-10-19 13:54:26 -07:00
Yury Semikhatsky 7e52357178
docs(fetch): ApiResponse -> APIResponse (#9623) 2021-10-19 11:17:23 -07:00
Dmitry Gozman 6d554a5e30
feat(reporter): expose more apis (#9603) 2021-10-19 08:38:04 -07:00
Yury Semikhatsky 6d727401bf
chore(fetch): rename ApiRequest* to APIRequest* (#9606) 2021-10-19 07:38:27 -07:00
Pavel Feldman e37660b068
feat(api): expose step location (#9602) 2021-10-18 21:06:18 -07:00
Yury Semikhatsky 79955fc4a8
docs: add response interception to network guide (#9598) 2021-10-18 17:53:06 -07:00
Yury Semikhatsky 42b535246f
docs(fetch): add api requests section under playwright test (#9595) 2021-10-18 15:44:47 -07:00
Yury Semikhatsky 990e80a23b
docs(fetch): add login via ApiRequestContext example (#9593) 2021-10-18 15:03:45 -07:00
Yury Semikhatsky 909b039b9a
docs: note that setViewportSize changes screen size (#9588) 2021-10-18 13:01:04 -07:00
Dmitry Gozman 7a4e799968
docs: add Selenium Grid integration (#9582) 2021-10-18 11:24:30 -07:00
Dmitry Gozman 4364c5f248
docs: update API testing doc (#9561) 2021-10-18 06:31:38 -07:00
Paul Biggar e473fc6a10
docs(test-runner): afterEach JSDoc description typo (#9542) 2021-10-16 12:36:07 +02:00
Feng Yu 0160c18f7a
docs: fix typo retried (#9562) 2021-10-15 19:24:03 -07:00
Pavel Feldman 99f3389b3b
feat(html): automatically use console reporter with html (#9559) 2021-10-15 19:18:56 -07:00
Yury Semikhatsky 235cd10a43
fix(runner): clarify where test.use() can be called (#9486) 2021-10-15 12:03:26 -07:00
Pavel Feldman 458945821f
doc(html): document html reporter (#9528) 2021-10-15 08:15:30 -07:00
Yury Semikhatsky 4680ef46de
docs: clarify default retry behavior (#9525) 2021-10-14 19:28:47 -07:00
Yury Semikhatsky 478fb34e35
docs: fix api-testing section id (#9514) 2021-10-14 11:20:15 -07:00
Dmitry Gozman bb013d14c0
docs: minor changes in apirequest (#9507) 2021-10-14 09:48:53 -07:00
Michael Rienstra bcae69e653
docs: minor change for readability (#9400) 2021-10-12 08:19:21 -07:00
knaitas cfe75fc755
docs(selector): change Python textContent to text_content (#9440)
Co-authored-by: Tadas Gedgaudas <tadas.gedgaudas@oxylabs.io>
2021-10-12 10:16:29 +02:00
Dmitry Anshilevich 8ae926efbf
docs(dotnet): fix .NET code example (#9415)
Co-authored-by: Max Schmitt <max@schmitt.mx>
2021-10-11 23:29:48 +02:00
Jason Hu 89e98d85fc
docs(protractor): add more protractor selectors (#9334)
Also fix `by.cssContainingText`, the text should not double quoted
2021-10-11 10:20:51 -07:00
Yury Semikhatsky 6c18f1a6f0
feat(fetch): accept numeric and bool params (#9345) 2021-10-08 09:23:59 -07:00
Mark Skelton 52f19a222e
docs: update showcase.md (add lariat library)
1. Removes expect-playwright and jest-playwright from the list.  These projects both officially recommend using the built-in Playwright test runner so it probably doesn't make sense to keep them in the showcase.
1. Adds Lariat to the list.  Lariat is a library I've developed at my company to simplify page object construction with support for nesting, nth based matching, portals, and more.
1. Add karma-playwright-launcher info
2021-10-08 18:01:54 +02:00
Yury Semikhatsky ddf17e62f6
docs: reference only focal base image in docs (#9399) 2021-10-08 08:54:55 -07:00
Yury Semikhatsky e3256ee5d5
docs(fetch): add API testing guide with example (#9385) 2021-10-07 19:38:13 -07:00
Yury Semikhatsky 51490a82e1
feat(fetch): add helper methods for put, patch, head, delete (#9374) 2021-10-07 12:42:26 -07:00
Darío Kondratiuk ddbd64e4df
docs(dotnet): Improve some dotnet docs (#9265)
Co-authored-by: Max Schmitt <max@schmitt.mx>
2021-10-06 21:07:31 +02:00
Pavel Feldman bc71d20d0f
feat(request): add global request fixture (#9332) 2021-10-06 10:09:27 -07:00
Yury Semikhatsky ab879fecd6
fix(api): make storageState option type same as context.storageState (#9333) 2021-10-06 09:02:41 -07:00
Max Schmitt 480e5a69e8
docs(browsers): fix missing JS snippets (#9339) 2021-10-06 17:43:31 +02:00
Pavel Feldman e8fdbbfa03
api: alias Fetch as ApiRequest (#9330) 2021-10-05 18:53:19 -07:00
Yury Semikhatsky 0469a7552b
fix(fetch): do not allow to call get/post with request (#9326) 2021-10-05 16:36:15 -07:00
Yury Semikhatsky 701a97beca
chore(fetch): unprefix _request and _newRequest (#9325) 2021-10-05 13:56:34 -07:00
Max Schmitt 97b6a344ac
docs: add docs page for how to parameterize your tests (#9291)
Co-authored-by: Pavel Feldman <pavel.feldman@gmail.com>
Co-authored-by: Joel Einbinder <joel.einbinder@gmail.com>
2021-10-05 20:22:16 +02:00
Max Schmitt e859a6996a
docs: fix wrongly annotated JS only paragraph (#9290) 2021-10-04 15:46:52 +02:00
Max Schmitt a280a17157
docs: add tabs for shell scripts (#9289) 2021-10-04 15:45:52 +02:00
Anish Karandikar 92c1aa20a7
docs(reporters): clarify dot reporter is default on CI (#9074) 2021-10-04 14:50:55 +02:00
Sidharth Vinod be30f9f1c4
feat(test-runner): Add GitHub Actions reporter (#9191) 2021-10-04 10:32:56 +02:00
Yury Semikhatsky 235eaca34a
fix(fetch): use data, form and multipart for different post data (#9248) 2021-10-01 12:11:33 -07:00
Nick Partridge b126a5685b
feat: add path option to toMatchSnapshot (#9156) 2021-10-01 09:15:44 -07:00
Sidharth Vinod 3296c21a80
feat(cli): Support trace file URLs (#9030) 2021-10-01 07:08:41 -07:00
Sidharth Vinod 2cf3448b6b
fix(docs): test-runner location column type (#9222) 2021-10-01 08:53:59 +02:00
Yury Semikhatsky 4e372dccb5
feat(fetch): import/export storageState (#9244) 2021-09-30 14:14:29 -07:00
Yury Semikhatsky b93718daea
feat(fetch): support ignoreHTTPSErrors option (#9206) 2021-09-28 15:33:36 -07:00
Pavel Feldman 2b055b3092
feat(api): introduce locator.waitFor (#9200) 2021-09-28 13:57:11 -07:00
Pavel Feldman 37ff9db7a0
chore: remove browserType.connect from .net - not yet ready (#9182) 2021-09-27 14:45:42 -07:00
Szymon Marczak 44c3b0270e
docs: mention empty string in userDataDir (#9069) 2021-09-27 12:50:35 -07:00
Dmitry Gozman 8dc8777ab4
feat(expect): toContainText(array) (#9160)
This matches when each expected item from the array
is matched to one of the resolved elements, in order.
Note this performs both "sub-array" and "substring" matching.

Drive-by: documentation fixes.
Drive-by: added "selector resolved to 3 elements" log line
when expecting arrays.
2021-09-27 11:14:35 -07:00
Kumar Aditya 3394bec364
docs(python): add docs about threading (#8829)
Co-authored-by: Max Schmitt <max@schmitt.mx>
2021-09-27 12:22:16 +02:00
Dmitry Gozman 0801a8c486
docs: cleanup test.describe.parallel.only doc (#9159) 2021-09-26 21:30:11 -07:00
Anže Vodovnik 6723a42544
docs(dotnet): add Null for dotnet in forced colors enum (#9051) 2021-09-24 16:31:53 +02:00
Max Schmitt 89aace688f
fix: make Serializable type any (#9059) 2021-09-23 11:06:34 -07:00
Yury Semikhatsky 79eb7744bc
feat(fetch): support options in playwright._newRequest (#9061) 2021-09-22 12:44:22 -07:00
Yury Semikhatsky 3c51f7d992
docs: improve ignorehttpserrors description (#9081) 2021-09-22 11:03:39 -07:00
Pavel Feldman d4073e8214 docs: assorted doc fixes 2021-09-21 15:10:22 -07:00
Pavel Feldman 4af576d0c7
docs: extract codegen docs (#9057) 2021-09-21 13:46:11 -07:00
Pavel Feldman d1a2803a57
docs: improve the auth state docs (#9052) 2021-09-21 13:20:50 -07:00
Max Schmitt 04858b3959 docs: release-notes adjust header indention 2021-09-21 22:16:43 +02:00
Max Schmitt 854cf9c25c
docs: add 1.15 release-notes (#9046)
Co-authored-by: Pavel Feldman <pavel.feldman@gmail.com>
2021-09-21 22:04:53 +02:00
Dmitry Gozman cb7285a8c0
docs(test): separate TestOptions from Fixtures (#9000) 2021-09-17 17:13:47 -07:00
Nav-2d e7a7a0cfc1
docs(test-configuration): Add actionTimeout to configuration (#8994) 2021-09-17 15:11:48 -07:00
Max Schmitt b5f6952f23
docs(core-concepts): mention newPage in browser context section (#8984) 2021-09-17 13:33:55 +02:00
Max Schmitt 6eee71a09b
docs: add GHA config for the deployment API (#8983) 2021-09-17 11:22:14 +02:00
Timm Krause 4cdc6f20c3
docs: fix "brower" typo in multi-pages doc 2021-09-17 10:36:51 +02:00
Yury Semikhatsky d3c71cc207
docs: clarify waitForURL(string) behavior (#8952) 2021-09-17 10:34:49 +02:00
Yury Semikhatsky 806a71a4f0
feat(fetch): support form data and json encodings (#8975) 2021-09-16 17:48:43 -07:00
Dmitry Gozman 545d793956
docs: an overview of reporter methods (#8948) 2021-09-15 15:29:06 -07:00
Yury Semikhatsky 2380b07f30
feat(fetch): introduce FetchRequest.dispose, fulfill with global fetch (#8945) 2021-09-15 14:02:55 -07:00
Max Schmitt 131239569d
feat(test-runner): add --debug CLI flag (#8938) 2021-09-15 21:19:31 +02:00
Nav-2d 476a3c59a3
docs(test-reporters): fix allure result path (#8930) 2021-09-14 20:56:28 -07:00
Max Schmitt e641bf2bed chore: hide Route.fulfill.response from != JS 2021-09-14 23:31:46 +02:00
Yury Semikhatsky 5141407c6b
fix(fetch): prefix request with underscore (#8922) 2021-09-14 12:56:09 -07:00
Joel Einbinder afae5bef5d
feat(mouse): page.mouse.wheel (#8690) 2021-09-14 15:22:52 -04:00
browse 95e1cfa0c1
docs(python): fix incorrect syntax in CDP snippet (#8909) 2021-09-14 11:18:28 +02:00
Nav-2d 9814dfb6c1
docs(test-typescript): fix grammatical mistake (#8907) 2021-09-13 21:10:31 -07:00
Dmitry Gozman 6722d95a7a
docs: fix markdown parser swallowing lines after code snippets (#8904) 2021-09-13 18:48:16 -07:00
Dmitry Gozman d9d2d809a2
fix(test): make use in config accept option values only (#8828)
Also include default options in FullConfig/FullProject.
Also make examples compile and add a test.
2021-09-13 17:50:31 -07:00
Yury Semikhatsky b79be5d98d
feat(fetch): introduce failOnStatusCode (#8896) 2021-09-13 15:38:27 -07:00
Yury Semikhatsky f8c0f0d637
feat(fetch): support query params (#8893) 2021-09-13 14:29:44 -07:00
Paulo Gonçalves 3e5645ecea
docs(showcase): example of parallel testing on AWS (#8870) 2021-09-13 13:52:57 -07:00
Pavel Feldman 64f9c3ba1d
feat(api): move fetch api into the namespace (#8871) 2021-09-13 12:43:07 -07:00
Andrey Lushnikov 67410ab70f
docs: fix protractor migration guide lists (#8875) 2021-09-13 12:06:47 +02:00
Pavel Feldman 798d0bfa9b
chore: fix headers api again (#8854) 2021-09-11 13:27:00 -07:00
Feng Yu 737b155869
docs(library-js.md): fix broken [managing browsers] link (#8856) 2021-09-11 07:32:50 -07:00
Yury Semikhatsky b6180055df
feat(fetch): make fetch api public (#8853) 2021-09-10 18:36:55 -07:00
Max Schmitt 33cd0d21da docs: rename protractor-js id to protractor 2021-09-10 19:40:36 +02:00
Max Schmitt a5fa190748
docs: no Response.finished() return value (#8819) 2021-09-10 08:02:34 -07:00
Max Schmitt 7f9d390cee docs(protractor): fixed invalid link reference 2021-09-10 13:17:20 +02:00