Filip/playwright
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

docs: add warning to locator.all (#22537)

Browse source 
References #22517.
This commit is contained in:
Dmitry Gozman 2023-04-23 21:18:46 -07:00 committed by GitHub
parent 62bd41912d
commit 05b113f050
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docs/src/api/class-locator.md
View file

@ -13,7 +13,13 @@ a way to find element(s) on the page at any moment. Locator can be created with
When locator points to a list of elements, returns array of locators, pointing
to respective elements.
Note that [`method: Locator.all`] does not wait for elements to match the locator, and instead immediately returns whatever is present in the page. To avoid flakiness when elements are loaded dynamically, wait for the loading to finish before calling [`method: Locator.all`].
:::note
[`method: Locator.all`] does not wait for elements to match the locator, and instead immediately returns whatever is present in the page.
When the list of elements changes dynamically, [`method: Locator.all`] will produce unpredictable and flaky results.
When the list of elements is stable, but loaded dynamically, wait for the full list to finish loading before calling [`method: Locator.all`].
:::
**Usage**

9
packages/playwright-core/types/types.d.ts vendored
View file

@ -10203,10 +10203,11 @@ export interface Locator {
/**
* When locator points to a list of elements, returns array of locators, pointing to respective elements.
*
* Note that [locator.all()](https://playwright.dev/docs/api/class-locator#locator-all) does not wait for elements to
* match the locator, and instead immediately returns whatever is present in the page. To avoid flakiness when
* elements are loaded dynamically, wait for the loading to finish before calling
* [locator.all()](https://playwright.dev/docs/api/class-locator#locator-all).
* **NOTE** [locator.all()](https://playwright.dev/docs/api/class-locator#locator-all) does not wait for elements to
* match the locator, and instead immediately returns whatever is present in the page. When the list of elements
* changes dynamically, [locator.all()](https://playwright.dev/docs/api/class-locator#locator-all) will produce
* unpredictable and flaky results. When the list of elements is stable, but loaded dynamically, wait for the full
* list to finish loading before calling [locator.all()](https://playwright.dev/docs/api/class-locator#locator-all).
*
* **Usage**
*