From 823f4f57f26fd52aa9f9ce298e51675561f310e9 Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Tue, 16 Aug 2022 11:02:15 -0700
Subject: [PATCH] fix(docs): make docs compile (#16588)

---
 docs/src/locators.md                      |   4 +-
 docs/src/testing-library-js.md            |   2 +-
 packages/playwright-core/types/types.d.ts | 300 +++++++++++-----------
 3 files changed, 157 insertions(+), 149 deletions(-)

diff --git a/docs/src/locators.md b/docs/src/locators.md
index 86764447f3..b94a6ef10e 100644
--- a/docs/src/locators.md
+++ b/docs/src/locators.md
@@ -70,7 +70,7 @@ await locator.ClickAsync();
 
 ### Creating Locators
 
-Use [`method: Page.locator`] method to create a locator. This method takes a selector that describes how to find an element in the page. Playwright supports many different selectors like [Text](./text-selector), [CSS](./#css-selector), [XPath](./#xpath-selectors) and many more. Learn more about available selectors and how to pick one in this [in-depth guide](./#selectors).
+Use [`method: Page.locator`] method to create a locator. This method takes a selector that describes how to find an element in the page. Playwright supports many different selectors like [Text](#text-selector), [CSS](#css-selector), [XPath](#xpath-selectors) and many more. Learn more about available selectors and how to pick one in this [in-depth guide](#selectors).
 
 ```js
 // Find by text.
@@ -189,7 +189,7 @@ await page.Locator("button").CountAsync();
 ```
 
 :::caution
-Using [`method: Locator.first`], [`method: Locator.last`], and [`method: Locator.nth`] is discouraged since it disables the concept of strictness, and as your page changes, Playwright may click on an element you did not intend. It's better to make your locator more specific. Learn more below in [Filtering Locators](#filtering-locators) and the [selectors guide](./#selectors).
+Using [`method: Locator.first`], [`method: Locator.last`], and [`method: Locator.nth`] is discouraged since it disables the concept of strictness, and as your page changes, Playwright may click on an element you did not intend. It's better to make your locator more specific. Learn more below in [Filtering Locators](#filtering-locators) and the [selectors guide](#selectors).
 :::
 
 ### Lists
diff --git a/docs/src/testing-library-js.md b/docs/src/testing-library-js.md
index 56f8a2875d..646342b02c 100644
--- a/docs/src/testing-library-js.md
+++ b/docs/src/testing-library-js.md
@@ -153,6 +153,6 @@ Learn more about Playwright Test runner:
 - [Getting Started](./intro)
 - [Experimental Component Testing](./test-components)
 - [Locators](./api/class-locator)
-- [Selectors](./selectors)
+- [Selectors](./locators#selectors)
 - [Assertions](./test-assertions)
 - [Auto-waiting](./actionability)
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index c85c16b037..b32d30a6e4 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -258,7 +258,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-query-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   $<K extends keyof HTMLElementTagNameMap>(selector: K, options?: { strict: boolean }): Promise<ElementHandleForTag<K> | null>;
@@ -271,7 +271,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-query-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   $(selector: string, options?: { strict: boolean }): Promise<ElementHandle<SVGElement | HTMLElement> | null>;
@@ -283,7 +283,7 @@ export interface Page {
    * return value resolves to `[]`.
    *
    * Shortcut for main frame's [frame.$$(selector)](https://playwright.dev/docs/api/class-frame#frame-query-selector-all).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$<K extends keyof HTMLElementTagNameMap>(selector: K): Promise<ElementHandleForTag<K>[]>;
   /**
@@ -293,7 +293,7 @@ export interface Page {
    * return value resolves to `[]`.
    *
    * Shortcut for main frame's [frame.$$(selector)](https://playwright.dev/docs/api/class-frame#frame-query-selector-all).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$(selector: string): Promise<ElementHandle<SVGElement | HTMLElement>[]>;
 
@@ -322,7 +322,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -353,7 +353,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -384,7 +384,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -415,7 +415,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector).
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -440,7 +440,7 @@ export interface Page {
    * const divCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -463,7 +463,7 @@ export interface Page {
    * const divCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -486,7 +486,7 @@ export interface Page {
    * const divCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -509,7 +509,7 @@ export interface Page {
    * const divCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -616,7 +616,7 @@ export interface Page {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options?: PageWaitForSelectorOptionsNotHidden): Promise<ElementHandleForTag<K>>;
@@ -648,7 +648,7 @@ export interface Page {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options?: PageWaitForSelectorOptionsNotHidden): Promise<ElementHandle<SVGElement | HTMLElement>>;
@@ -680,7 +680,7 @@ export interface Page {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options: PageWaitForSelectorOptions): Promise<ElementHandleForTag<K> | null>;
@@ -712,7 +712,7 @@ export interface Page {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options: PageWaitForSelectorOptions): Promise<null|ElementHandle<SVGElement | HTMLElement>>;
@@ -1850,7 +1850,7 @@ export interface Page {
    * zero timeout disables this.
    *
    * Shortcut for main frame's [frame.check(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-check).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   check(selector: string, options?: {
@@ -1911,7 +1911,7 @@ export interface Page {
    * zero timeout disables this.
    *
    * Shortcut for main frame's [frame.click(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-click).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   click(selector: string, options?: {
@@ -2032,7 +2032,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.dblclick(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-dblclick).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   dblclick(selector: string, options?: {
@@ -2124,7 +2124,7 @@ export interface Page {
    * await page.dispatchEvent('#source', 'dragstart', { dataTransfer });
    * ```
    *
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param type DOM event type: `"click"`, `"dragstart"`, etc.
    * @param eventInit Optional event-specific initialization properties.
    * @param options
@@ -2146,8 +2146,8 @@ export interface Page {
   }): Promise<void>;
 
   /**
-   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
-   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
+   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   dragAndDrop(source: string, target: string, options?: {
@@ -2324,7 +2324,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.fill(selector, value[, options])](https://playwright.dev/docs/api/class-frame#frame-fill).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param value Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
    * @param options
    */
@@ -2361,7 +2361,7 @@ export interface Page {
    * waits until a matching element appears in the DOM.
    *
    * Shortcut for main frame's [frame.focus(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-focus).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   focus(selector: string, options?: {
@@ -2415,7 +2415,7 @@ export interface Page {
    * await locator.click();
    * ```
    *
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   frameLocator(selector: string): FrameLocator;
 
@@ -2426,7 +2426,7 @@ export interface Page {
 
   /**
    * Returns element attribute value.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param name Attribute name to get the value for.
    * @param options
    */
@@ -2568,7 +2568,7 @@ export interface Page {
    * zero timeout disables this.
    *
    * Shortcut for main frame's [frame.hover(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-hover).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   hover(selector: string, options?: {
@@ -2616,7 +2616,7 @@ export interface Page {
 
   /**
    * Returns `element.innerHTML`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   innerHTML(selector: string, options?: {
@@ -2637,7 +2637,7 @@ export interface Page {
 
   /**
    * Returns `element.innerText`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   innerText(selector: string, options?: {
@@ -2661,7 +2661,7 @@ export interface Page {
    *
    * Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
    * [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   inputValue(selector: string, options?: {
@@ -2682,7 +2682,7 @@ export interface Page {
 
   /**
    * Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isChecked(selector: string, options?: {
@@ -2708,7 +2708,7 @@ export interface Page {
 
   /**
    * Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/docs/actionability#enabled).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isDisabled(selector: string, options?: {
@@ -2729,7 +2729,7 @@ export interface Page {
 
   /**
    * Returns whether the element is [editable](https://playwright.dev/docs/actionability#editable).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isEditable(selector: string, options?: {
@@ -2750,7 +2750,7 @@ export interface Page {
 
   /**
    * Returns whether the element is [enabled](https://playwright.dev/docs/actionability#enabled).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isEnabled(selector: string, options?: {
@@ -2772,7 +2772,7 @@ export interface Page {
   /**
    * Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/docs/actionability#visible).  `selector` that does not
    * match any elements is considered hidden.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isHidden(selector: string, options?: {
@@ -2794,7 +2794,7 @@ export interface Page {
   /**
    * Returns whether the element is [visible](https://playwright.dev/docs/actionability#visible). `selector` that does not match any elements is
    * considered not visible.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isVisible(selector: string, options?: {
@@ -2824,7 +2824,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.locator(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-locator).
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   locator(selector: string, options?: {
@@ -3045,7 +3045,7 @@ export interface Page {
    * await browser.close();
    * ```
    *
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param key Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
    * @param options
    */
@@ -3235,7 +3235,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.selectOption(selector, values[, options])](https://playwright.dev/docs/api/class-frame#frame-select-option).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param values Options to select. If the `<select>` has the `multiple` attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. String values are equivalent to `{value:'string'}`. Option
    * is considered matching if all specified properties match.
    * @param options
@@ -3315,7 +3315,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.setChecked(selector, checked[, options])](https://playwright.dev/docs/api/class-frame#frame-set-checked).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param checked Whether to check or uncheck the checkbox.
    * @param options
    */
@@ -3437,7 +3437,7 @@ export interface Page {
    * [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
    * `<label>` element that has an associated
    * [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param files
    * @param options
    */
@@ -3546,7 +3546,7 @@ export interface Page {
    * `hasTouch` option of the browser context be set to true.
    *
    * Shortcut for main frame's [frame.tap(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-tap).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   tap(selector: string, options?: {
@@ -3601,7 +3601,7 @@ export interface Page {
 
   /**
    * Returns `element.textContent`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   textContent(selector: string, options?: {
@@ -3643,7 +3643,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.type(selector, text[, options])](https://playwright.dev/docs/api/class-frame#frame-type).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param text A text to type into a focused element.
    * @param options
    */
@@ -3692,7 +3692,7 @@ export interface Page {
    *
    * Shortcut for main frame's
    * [frame.uncheck(selector[, options])](https://playwright.dev/docs/api/class-frame#frame-uncheck).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   uncheck(selector: string, options?: {
@@ -4406,8 +4406,8 @@ export interface Frame {
    * > NOTE: The use of [ElementHandle] is discouraged, use [Locator] objects and web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns `null`.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns `null`.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   $<K extends keyof HTMLElementTagNameMap>(selector: K, options?: { strict: boolean }): Promise<ElementHandleForTag<K> | null>;
@@ -4417,8 +4417,8 @@ export interface Frame {
    * > NOTE: The use of [ElementHandle] is discouraged, use [Locator] objects and web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns `null`.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns `null`.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   $(selector: string, options?: { strict: boolean }): Promise<ElementHandle<SVGElement | HTMLElement> | null>;
@@ -4429,8 +4429,9 @@ export interface Frame {
    * > NOTE: The use of [ElementHandle] is discouraged, use [Locator] objects instead.
    *
    * The method finds all elements matching the specified selector within the frame. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns empty array.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns empty
+   * array.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$<K extends keyof HTMLElementTagNameMap>(selector: K): Promise<ElementHandleForTag<K>[]>;
   /**
@@ -4439,8 +4440,9 @@ export interface Frame {
    * > NOTE: The use of [ElementHandle] is discouraged, use [Locator] objects instead.
    *
    * The method finds all elements matching the specified selector within the frame. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns empty array.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns empty
+   * array.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$(selector: string): Promise<ElementHandle<SVGElement | HTMLElement>[]>;
 
@@ -4453,8 +4455,8 @@ export interface Frame {
    * [Locator] helper methods or web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame and passes it as a first argument to
-   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, the
-   * method throws an error.
+   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the
+   * selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector)
@@ -4468,7 +4470,7 @@ export interface Frame {
    * const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -4483,8 +4485,8 @@ export interface Frame {
    * [Locator] helper methods or web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame and passes it as a first argument to
-   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, the
-   * method throws an error.
+   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the
+   * selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector)
@@ -4498,7 +4500,7 @@ export interface Frame {
    * const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -4513,8 +4515,8 @@ export interface Frame {
    * [Locator] helper methods or web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame and passes it as a first argument to
-   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, the
-   * method throws an error.
+   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the
+   * selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector)
@@ -4528,7 +4530,7 @@ export interface Frame {
    * const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -4543,8 +4545,8 @@ export interface Frame {
    * [Locator] helper methods or web-first assertions instead.
    *
    * The method finds an element matching the specified selector within the frame and passes it as a first argument to
-   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, the
-   * method throws an error.
+   * `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the
+   * selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$eval(selector, pageFunction[, arg, options])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector)
@@ -4558,7 +4560,7 @@ export interface Frame {
    * const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    * @param options
@@ -4573,7 +4575,7 @@ export interface Frame {
    * [Locator] helper methods and web-first assertions do a better job.
    *
    * The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector-all)
@@ -4585,7 +4587,7 @@ export interface Frame {
    * const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -4598,7 +4600,7 @@ export interface Frame {
    * [Locator] helper methods and web-first assertions do a better job.
    *
    * The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector-all)
@@ -4610,7 +4612,7 @@ export interface Frame {
    * const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -4623,7 +4625,7 @@ export interface Frame {
    * [Locator] helper methods and web-first assertions do a better job.
    *
    * The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector-all)
@@ -4635,7 +4637,7 @@ export interface Frame {
    * const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -4648,7 +4650,7 @@ export interface Frame {
    * [Locator] helper methods and web-first assertions do a better job.
    *
    * The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    *
    * If `pageFunction` returns a [Promise], then
    * [frame.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-eval-on-selector-all)
@@ -4660,7 +4662,7 @@ export interface Frame {
    * const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -4759,7 +4761,7 @@ export interface Frame {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options?: PageWaitForSelectorOptionsNotHidden): Promise<ElementHandleForTag<K>>;
@@ -4791,7 +4793,7 @@ export interface Frame {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options?: PageWaitForSelectorOptionsNotHidden): Promise<ElementHandle<SVGElement | HTMLElement>>;
@@ -4823,7 +4825,7 @@ export interface Frame {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options: PageWaitForSelectorOptions): Promise<ElementHandleForTag<K> | null>;
@@ -4855,7 +4857,7 @@ export interface Frame {
    * })();
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options: PageWaitForSelectorOptions): Promise<null|ElementHandle<SVGElement | HTMLElement>>;
@@ -4928,7 +4930,7 @@ export interface Frame {
    *
    * When all steps combined have not finished during the specified `timeout`, this method throws a [TimeoutError]. Passing
    * zero timeout disables this.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   check(selector: string, options?: {
@@ -4989,7 +4991,7 @@ export interface Frame {
    *
    * When all steps combined have not finished during the specified `timeout`, this method throws a [TimeoutError]. Passing
    * zero timeout disables this.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   click(selector: string, options?: {
@@ -5077,7 +5079,7 @@ export interface Frame {
    * zero timeout disables this.
    *
    * > NOTE: `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   dblclick(selector: string, options?: {
@@ -5169,7 +5171,7 @@ export interface Frame {
    * await frame.dispatchEvent('#source', 'dragstart', { dataTransfer });
    * ```
    *
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param type DOM event type: `"click"`, `"dragstart"`, etc.
    * @param eventInit Optional event-specific initialization properties.
    * @param options
@@ -5191,8 +5193,8 @@ export interface Frame {
   }): Promise<void>;
 
   /**
-   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
-   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
+   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   dragAndDrop(source: string, target: string, options?: {
@@ -5261,7 +5263,7 @@ export interface Frame {
    *
    * To send fine-grained keyboard events, use
    * [frame.type(selector, text[, options])](https://playwright.dev/docs/api/class-frame#frame-type).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param value Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
    * @param options
    */
@@ -5296,7 +5298,7 @@ export interface Frame {
   /**
    * This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
    * waits until a matching element appears in the DOM.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   focus(selector: string, options?: {
@@ -5343,13 +5345,13 @@ export interface Frame {
    * await locator.click();
    * ```
    *
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   frameLocator(selector: string): FrameLocator;
 
   /**
    * Returns element attribute value.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param name Attribute name to get the value for.
    * @param options
    */
@@ -5430,7 +5432,7 @@ export interface Frame {
    *
    * When all steps combined have not finished during the specified `timeout`, this method throws a [TimeoutError]. Passing
    * zero timeout disables this.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   hover(selector: string, options?: {
@@ -5478,7 +5480,7 @@ export interface Frame {
 
   /**
    * Returns `element.innerHTML`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   innerHTML(selector: string, options?: {
@@ -5499,7 +5501,7 @@ export interface Frame {
 
   /**
    * Returns `element.innerText`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   innerText(selector: string, options?: {
@@ -5523,7 +5525,7 @@ export interface Frame {
    *
    * Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
    * [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   inputValue(selector: string, options?: {
@@ -5544,7 +5546,7 @@ export interface Frame {
 
   /**
    * Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isChecked(selector: string, options?: {
@@ -5570,7 +5572,7 @@ export interface Frame {
 
   /**
    * Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/docs/actionability#enabled).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isDisabled(selector: string, options?: {
@@ -5591,7 +5593,7 @@ export interface Frame {
 
   /**
    * Returns whether the element is [editable](https://playwright.dev/docs/actionability#editable).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isEditable(selector: string, options?: {
@@ -5612,7 +5614,7 @@ export interface Frame {
 
   /**
    * Returns whether the element is [enabled](https://playwright.dev/docs/actionability#enabled).
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isEnabled(selector: string, options?: {
@@ -5634,7 +5636,7 @@ export interface Frame {
   /**
    * Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/docs/actionability#visible).  `selector` that does not
    * match any elements is considered hidden.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isHidden(selector: string, options?: {
@@ -5656,7 +5658,7 @@ export interface Frame {
   /**
    * Returns whether the element is [visible](https://playwright.dev/docs/actionability#visible). `selector` that does not match any elements is
    * considered not visible.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   isVisible(selector: string, options?: {
@@ -5681,7 +5683,7 @@ export interface Frame {
    * different DOM elements. That would happen if the DOM structure between those actions has changed.
    *
    * [Learn more about locators](https://playwright.dev/docs/locators).
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   locator(selector: string, options?: {
@@ -5737,7 +5739,7 @@ export interface Frame {
    *
    * Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are supported as well. When specified with the
    * modifier, modifier is pressed and being held while the subsequent key is being pressed.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param key Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
    * @param options
    */
@@ -5792,7 +5794,7 @@ export interface Frame {
    * frame.selectOption('select#colors', 'red', 'green', 'blue');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param values Options to select. If the `<select>` has the `multiple` attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. String values are equivalent to `{value:'string'}`. Option
    * is considered matching if all specified properties match.
    * @param options
@@ -5869,7 +5871,7 @@ export interface Frame {
    *
    * When all steps combined have not finished during the specified `timeout`, this method throws a [TimeoutError]. Passing
    * zero timeout disables this.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param checked Whether to check or uncheck the checkbox.
    * @param options
    */
@@ -5950,7 +5952,7 @@ export interface Frame {
    * [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
    * `<label>` element that has an associated
    * [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param files
    * @param options
    */
@@ -6021,7 +6023,7 @@ export interface Frame {
    * zero timeout disables this.
    *
    * > NOTE: `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   tap(selector: string, options?: {
@@ -6076,7 +6078,7 @@ export interface Frame {
 
   /**
    * Returns `element.textContent`.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   textContent(selector: string, options?: {
@@ -6113,7 +6115,7 @@ export interface Frame {
    * await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
    * ```
    *
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param text A text to type into a focused element.
    * @param options
    */
@@ -6159,7 +6161,7 @@ export interface Frame {
    *
    * When all steps combined have not finished during the specified `timeout`, this method throws a [TimeoutError]. Passing
    * zero timeout disables this.
-   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   uncheck(selector: string, options?: {
@@ -7699,27 +7701,29 @@ export interface JSHandle<T = any> {
 export interface ElementHandle<T=Node> extends JSHandle<T> {
   /**
    * The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns `null`.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns `null`.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $<K extends keyof HTMLElementTagNameMap>(selector: K, options?: { strict: boolean }): Promise<ElementHandleForTag<K> | null>;
   /**
    * The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns `null`.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns `null`.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $(selector: string, options?: { strict: boolean }): Promise<ElementHandle<SVGElement | HTMLElement> | null>;
 
   /**
    * The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns empty array.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns empty
+   * array.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$<K extends keyof HTMLElementTagNameMap>(selector: K): Promise<ElementHandleForTag<K>[]>;
   /**
    * The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See
-   * [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the selector, returns empty array.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements match the selector, returns empty
+   * array.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   $$(selector: string): Promise<ElementHandle<SVGElement | HTMLElement>[]>;
 
@@ -7727,8 +7731,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the
-   * selector, the method throws an error.
+   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements
+   * match the selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector)
@@ -7742,7 +7746,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7751,8 +7755,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the
-   * selector, the method throws an error.
+   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements
+   * match the selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector)
@@ -7766,7 +7770,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7775,8 +7779,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the
-   * selector, the method throws an error.
+   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements
+   * match the selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector)
@@ -7790,7 +7794,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7799,8 +7803,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details. If no elements match the
-   * selector, the method throws an error.
+   * argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more details. If no elements
+   * match the selector, the method throws an error.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector)
@@ -7814,7 +7818,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7824,7 +7828,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more
+   * details.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector-all)
@@ -7844,7 +7849,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7853,7 +7858,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more
+   * details.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector-all)
@@ -7873,7 +7879,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7882,7 +7888,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more
+   * details.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector-all)
@@ -7902,7 +7909,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7911,7 +7918,8 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * Returns the return value of `pageFunction`.
    *
    * The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * matched elements as a first argument to `pageFunction`. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for more
+   * details.
    *
    * If `pageFunction` returns a [Promise], then
    * [elementHandle.$$eval(selector, pageFunction[, arg])](https://playwright.dev/docs/api/class-elementhandle#element-handle-eval-on-selector-all)
@@ -7931,7 +7939,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    * expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
    * ```
    *
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param pageFunction Function to be evaluated in the page context.
    * @param arg Optional argument to pass to `pageFunction`.
    */
@@ -7955,7 +7963,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    *
    * > NOTE: This method does not work across navigations, use
    * [page.waitForSelector(selector[, options])](https://playwright.dev/docs/api/class-page#page-wait-for-selector) instead.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options?: ElementHandleWaitForSelectorOptionsNotHidden): Promise<ElementHandleForTag<K>>;
@@ -7977,7 +7985,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    *
    * > NOTE: This method does not work across navigations, use
    * [page.waitForSelector(selector[, options])](https://playwright.dev/docs/api/class-page#page-wait-for-selector) instead.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options?: ElementHandleWaitForSelectorOptionsNotHidden): Promise<ElementHandle<SVGElement | HTMLElement>>;
@@ -7999,7 +8007,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    *
    * > NOTE: This method does not work across navigations, use
    * [page.waitForSelector(selector[, options])](https://playwright.dev/docs/api/class-page#page-wait-for-selector) instead.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector<K extends keyof HTMLElementTagNameMap>(selector: K, options: ElementHandleWaitForSelectorOptions): Promise<ElementHandleForTag<K> | null>;
@@ -8021,7 +8029,7 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {
    *
    * > NOTE: This method does not work across navigations, use
    * [page.waitForSelector(selector[, options])](https://playwright.dev/docs/api/class-page#page-wait-for-selector) instead.
-   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to query for. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   waitForSelector(selector: string, options: ElementHandleWaitForSelectorOptions): Promise<null|ElementHandle<SVGElement | HTMLElement>>;
@@ -9601,7 +9609,7 @@ export interface Locator {
    * await locator.click();
    * ```
    *
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   frameLocator(selector: string): FrameLocator;
 
@@ -9814,7 +9822,7 @@ export interface Locator {
   /**
    * The method finds an element matching the specified selector in the `Locator`'s subtree. It also accepts filter options,
    * similar to [locator.filter([options])](https://playwright.dev/docs/api/class-locator#locator-filter) method.
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   locator(selector: string, options?: {
@@ -14480,7 +14488,7 @@ export interface FrameLocator {
   /**
    * When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
    * that iframe.
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    */
   frameLocator(selector: string): FrameLocator;
 
@@ -14491,7 +14499,7 @@ export interface FrameLocator {
 
   /**
    * The method finds an element matching the specified selector in the FrameLocator's subtree.
-   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param selector A selector to use when resolving DOM element. See [working with selectors](https://playwright.dev/docs/locators#selectors) for more details.
    * @param options
    */
   locator(selector: string, options?: {
@@ -14855,8 +14863,8 @@ export const firefox: BrowserType;
 export const request: APIRequest;
 
 /**
- * Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/docs/selectors) for more
- * information.
+ * Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for
+ * more information.
  */
 export const selectors: Selectors;
 
@@ -15497,8 +15505,8 @@ export interface Route {
 }
 
 /**
- * Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/docs/selectors) for more
- * information.
+ * Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/docs/locators#selectors) for
+ * more information.
  */
 export interface Selectors {
   /**