docs: warn that ElementHandle bypasses humanize patches

2026-06-23 11:41:46 +02:00 · 2026-03-18 07:51:07 +01:00
parent 6550f3ad6c
commit 2813b3dc4c
1 changed files with 2 additions and 0 deletions
@@ -501,6 +501,8 @@ const browser = await launch({

 Access the original un-patched Playwright page at `page._original` if you need raw speed for a specific call.

+> **Note:** Always use `page.click(selector)`, `page.type(selector, text)`, `page.hover(selector)`, or `page.locator(selector).*` — these go through the full humanize pipeline. Avoid `page.query_selector()` — `ElementHandle` objects bypass all patches, so mouse movement teleports, keyboard events fire without timing, and scroll has no human curve.
+
 > Contributed by [@evelaa123](https://github.com/evelaa123) — full Playwright API coverage.

 ## Configuration