From 7b1b2dd7411449ea18c7b40e7d24cdba7c586f85 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 18 May 2023 02:51:36 +0200
Subject: [PATCH] docs(assertions): add note for setting global python expect
 timeout (#23106)

Fixes https://github.com/microsoft/playwright-python/issues/1358
---
 .../src/test-assertions-csharp-java-python.md | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/src/test-assertions-csharp-java-python.md b/docs/src/test-assertions-csharp-java-python.md
index 4c2e208ec5..0cf50c8d7b 100644
--- a/docs/src/test-assertions-csharp-java-python.md
+++ b/docs/src/test-assertions-csharp-java-python.md
@@ -52,3 +52,25 @@ E       waiting for get_by_text("Name")
 
 tests/test_foobar.py:22: AssertionError
 ```
+
+## Setting a custom timeout
+* langs: python
+
+You can specify a custom timeout for assertions either globally or per assertion. The default timeout is 5 seconds.
+
+### Global timeout
+
+```python title="conftest.py"
+from playwright.sync_api import expect
+
+expect.set_options(timeout=10_000)
+```
+
+### Per assertion timeout
+
+```python title="test_foobar.py"
+from playwright.sync_api import expect
+
+def test_foobar(page: Page) -> None:
+    expect(page.get_by_text("Name")).to_be_visible(timeout=10_000)
+```