docs(context): document the `browser()` call from persistent context (#36216)

2025-06-05 11:33:48 -07:00 · 2025-06-05 11:33:48 -07:00 · 2bc8ed0fc9
parent a0eb891880
commit 2bc8ed0fc9
3 changed files with 5 additions and 3 deletions
--- a/docs/src/api/class-browsercontext.md
+++ b/docs/src/api/class-browsercontext.md
@ -467,7 +467,7 @@ All existing background pages in the context.
 * since: v1.8
 - returns: <[null]|[Browser]>

-Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+Gets the browser instance that owns the context. Returns `null` if the context is created outside of normal browser, e.g. Android or Electron.

 ## async method: BrowserContext.clearCookies
 * since: v1.8
--- a/packages/playwright-client/types/types.d.ts
+++ b/packages/playwright-client/types/types.d.ts
@ -8840,7 +8840,8 @@ export interface BrowserContext {
  backgroundPages(): Array<Page>;

  /**
-   * Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+   * Gets the browser instance that owns the context. Returns `null` if the context is created outside of normal
+   * browser, e.g. Android or Electron.
   */
  browser(): null|Browser;

--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@ -8840,7 +8840,8 @@ export interface BrowserContext {
  backgroundPages(): Array<Page>;

  /**
-   * Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+   * Gets the browser instance that owns the context. Returns `null` if the context is created outside of normal
+   * browser, e.g. Android or Electron.
   */
  browser(): null|Browser;