docs(click): mention that trial emits keydown/keyup if modifier is given

docs/src/api/class-elementhandle.md

@@ -231,8 +231,11 @@ When all steps combined have not finished during the specified [`option: timeout
 ### option: ElementHandle.click.timeout = %%-input-timeout-js-%%
 * since: v1.8
 
-### option: ElementHandle.click.trial = %%-input-trial-%%
+### option: ElementHandle.click.trial
 * since: v1.11
+- `trial` <[boolean]>
+
+When set, this method only performs the [actionability](../actionability.md) checks, emits a `keydown`/`keyup` event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it.
 
 ## async method: ElementHandle.contentFrame
 * since: v1.8

docs/src/api/class-frame.md

@@ -280,8 +280,11 @@ When all steps combined have not finished during the specified [`option: timeout
 ### option: Frame.click.timeout = %%-input-timeout-js-%%
 * since: v1.8
 
-### option: Frame.click.trial = %%-input-trial-%%
+### option: Frame.click.trial
 * since: v1.11
+- `trial` <[boolean]>
+
+When set, this method only performs the [actionability](../actionability.md) checks, emits a `keydown`/`keyup` event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it.
 
 ## async method: Frame.content
 * since: v1.8

docs/src/api/class-locator.md

@@ -433,8 +433,11 @@ await page.Locator("canvas").ClickAsync(new() {
 ### option: Locator.click.timeout = %%-input-timeout-js-%%
 * since: v1.14
 
-### option: Locator.click.trial = %%-input-trial-%%
+### option: Locator.click.trial
 * since: v1.14
+- `trial` <[boolean]>
+
+When set, this method only performs the [actionability](../actionability.md) checks, emits a `keydown`/`keyup` event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it.
 
 ## async method: Locator.count
 * since: v1.14

docs/src/api/class-page.md

@@ -812,8 +812,11 @@ When all steps combined have not finished during the specified [`option: timeout
 ### option: Page.click.timeout = %%-input-timeout-js-%%
 * since: v1.8
 
-### option: Page.click.trial = %%-input-trial-%%
+### option: Page.click.trial
 * since: v1.11
+- `trial` <[boolean]>
+
+When set, this method only performs the [actionability](../actionability.md) checks, emits a `keydown`/`keyup` event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it.
 
 ## async method: Page.close
 * since: v1.8

packages/playwright-core/types/types.d.ts

@@ -2119,8 +2119,9 @@ export interface Page {
     timeout?: number;
 
     /**
-     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks and skips the action. Defaults
-     * to `false`. Useful to wait until the element is ready for the action without performing it.
+     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks, emits a `keydown`/`keyup`
+     * event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is
+     * ready for the action without performing it.
      */
     trial?: boolean;
   }): Promise<void>;
@@ -5844,8 +5845,9 @@ export interface Frame {
     timeout?: number;
 
     /**
-     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks and skips the action. Defaults
-     * to `false`. Useful to wait until the element is ready for the action without performing it.
+     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks, emits a `keydown`/`keyup`
+     * event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is
+     * ready for the action without performing it.
      */
     trial?: boolean;
   }): Promise<void>;
@@ -10607,8 +10609,9 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
     timeout?: number;
 
     /**
-     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks and skips the action. Defaults
-     * to `false`. Useful to wait until the element is ready for the action without performing it.
+     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks, emits a `keydown`/`keyup`
+     * event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is
+     * ready for the action without performing it.
      */
     trial?: boolean;
   }): Promise<void>;
@@ -12044,8 +12047,9 @@ export interface Locator {
     timeout?: number;
 
     /**
-     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks and skips the action. Defaults
-     * to `false`. Useful to wait until the element is ready for the action without performing it.
+     * When set, this method only performs the [actionability](https://playwright.dev/docs/actionability) checks, emits a `keydown`/`keyup`
+     * event if a `modifier` is passed and skips the action. Defaults to `false`. Useful to wait until the element is
+     * ready for the action without performing it.
      */
     trial?: boolean;
   }): Promise<void>;