diff --git a/docs/src/api/class-elementhandle.md b/docs/src/api/class-elementhandle.md
index 8ada198207..c76c3b20bd 100644
--- a/docs/src/api/class-elementhandle.md
+++ b/docs/src/api/class-elementhandle.md
@@ -998,3 +998,18 @@ This method does not work across navigations, use [`method: Page.waitForSelector
 ### option: ElementHandle.waitForSelector.timeout = %%-input-timeout-%%
 
 ### option: ElementHandle.waitForSelector.strict = %%-input-strict-%%
+
+## async method: ElementHandle.waitForSelector
+* langs: python
+- returns: <[ElementHandle]>
+
+## async method: ElementHandle.waitForSelectorHidden
+* langs: python, csharp
+
+Returns when element specified by selector satisfies [`option: state`] option. See [`method: ElementHandle.waitForSelector`] for more information.
+
+### param: ElementHandle.waitForSelectorHidden.selector = %%-query-selector-%%
+### option: ElementHandle.waitForSelectorHidden.state = %%-wait-for-selector-state-hidden-%%
+### option: ElementHandle.waitForSelectorHidden.timeout = %%-input-timeout-%%
+### option: ElementHandle.waitForSelectorHidden.strict = %%-input-strict-%%
+
diff --git a/docs/src/api/class-frame.md b/docs/src/api/class-frame.md
index 929d1453cc..6bb13d50ef 100644
--- a/docs/src/api/class-frame.md
+++ b/docs/src/api/class-frame.md
@@ -1611,6 +1611,22 @@ class FrameExamples
 ### option: Frame.waitForSelector.strict = %%-input-strict-%%
 ### option: Frame.waitForSelector.timeout = %%-input-timeout-%%
 
+
+## async method: Frame.waitForSelector
+* langs: python
+- returns: <[ElementHandle]>
+
+## async method: Frame.waitForSelectorHidden
+* langs: python, csharp
+
+Returns when element specified by selector satisfies [`option: state`] option. See [`method: Frame.waitForSelector`] for more information.
+
+### param: Frame.waitForSelectorHidden.selector = %%-query-selector-%%
+### option: Frame.waitForSelectorHidden.state = %%-wait-for-selector-state-hidden-%%
+### option: Frame.waitForSelectorHidden.strict = %%-input-strict-%%
+### option: Frame.waitForSelectorHidden.timeout = %%-input-timeout-%%
+
+
 ## async method: Frame.waitForTimeout
 
 Waits for the given [`param: timeout`] in milliseconds.
diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md
index f4c2699fb9..58fa3ce221 100644
--- a/docs/src/api/class-page.md
+++ b/docs/src/api/class-page.md
@@ -3732,6 +3732,21 @@ class FrameExamples
 ### option: Page.waitForSelector.strict = %%-input-strict-%%
 ### option: Page.waitForSelector.timeout = %%-input-timeout-%%
 
+## async method: Page.waitForSelector
+* langs: python
+- returns: <[ElementHandle]>
+
+## async method: Page.waitForSelectorHidden
+* langs: python, csharp
+
+Returns when element specified by selector satisfies [`option: state`] option. See [`method: Page.waitForSelector`] for more information.
+
+### param: Page.waitForSelectorHidden.selector = %%-query-selector-%%
+### option: Page.waitForSelectorHidden.state = %%-wait-for-selector-state-hidden-%%
+### option: Page.waitForSelectorHidden.strict = %%-input-strict-%%
+### option: Page.waitForSelectorHidden.timeout = %%-input-timeout-%%
+
+
 ## async method: Page.waitForTimeout
 
 Waits for the given [`param: timeout`] in milliseconds.
diff --git a/docs/src/api/params.md b/docs/src/api/params.md
index 3a1021f9cd..d811f97515 100644
--- a/docs/src/api/params.md
+++ b/docs/src/api/params.md
@@ -145,6 +145,14 @@ Defaults to `'visible'`. Can be either:
 * `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
   This is opposite to the `'visible'` option.
 
+## wait-for-selector-state-hidden
+- `state` <[WaitForSelectorStateHidden]<"detached"|"hidden">>
+
+Defaults to `'hidden'`. Can be either:
+* `'detached'` - wait for element to not be present in DOM.
+* `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
+  This is opposite to the `'visible'` option.
+
 ## js-python-wait-for-function-polling
 * langs: js, python
 - `polling` <[float]|"raf">