Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

docs: clarify locator.evaluate{,Handle} timeout option (#35319)

Dmitry Gozmanb3d19e2f80e0
diff --git a/docs/src/api/class-locator.md b/docs/src/api/class-locator.md
index 2a2d81f6eb..25462a0ed9 100644
--- a/docs/src/api/class-locator.md
+++ b/docs/src/api/class-locator.md
@@ -883,11 +883,19 @@ If [`param: expression`] throws or rejects, this method throws.
Optional argument to pass to [`param: expression`].
-### option: Locator.evaluate.timeout = %%-input-timeout-%%
+### option: Locator.evaluate.timeout
* since: v1.14
+* langs: python, java, csharp
+- `timeout` <[float]>
+
+Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved, evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
-### option: Locator.evaluate.timeout = %%-input-timeout-js-%%
+### option: Locator.evaluate.timeout
* since: v1.14
+* langs: js
+- `timeout` <[float]>
+
+Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved, evaluation itself is not limited by the timeout. Defaults to `0` - no timeout.
## async method: Locator.evaluateAll
* since: v1.14
@@ -972,11 +980,19 @@ See [`method: Page.evaluateHandle`] for more details.
Optional argument to pass to [`param: expression`].
-### option: Locator.evaluateHandle.timeout = %%-input-timeout-%%
+### option: Locator.evaluateHandle.timeout
* since: v1.14
+* langs: python, java, csharp
+- `timeout` <[float]>
+
+Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved, evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
-### option: Locator.evaluateHandle.timeout = %%-input-timeout-js-%%
+### option: Locator.evaluateHandle.timeout
* since: v1.14
+* langs: js
+- `timeout` <[float]>
+
+Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved, evaluation itself is not limited by the timeout. Defaults to `0` - no timeout.
## async method: Locator.fill
* since: v1.14