java.lang.Object
- com.microsoft.playwright.BrowserType.LaunchPersistentContextOptions

Enclosing interface:: BrowserType

public static class BrowserType.LaunchPersistentContextOptions
extends Object

Field Summary

Fields
Modifier and Type	Field	Description
`Boolean`	`acceptDownloads`	Whether to automatically download all the attachments.
`List<String>`	`args`	NOTE: Use custom browser args at your own risk, as some of them may break Playwright functionality.
`String`	`baseURL`	When using `Page.navigate()`, `Page.route()`, `Page.waitForURL()`, `Page.waitForRequest()`, or `Page.waitForResponse()` it takes the base URL in consideration by using the `URL()` constructor for building the corresponding URL.
`Boolean`	`bypassCSP`	Toggles bypassing page's Content-Security-Policy.
`Object`	`channel`	Browser distribution channel.
`Boolean`	`chromiumSandbox`	Enable Chromium sandboxing.
`Optional<ColorScheme>`	`colorScheme`	Emulates `"prefers-colors-scheme"` media feature, supported values are `"light"`, `"dark"`, `"no-preference"`.
`Double`	`deviceScaleFactor`	Specify device scale factor (can be thought of as dpr).
`Boolean`	`devtools`	Deprecated. Use debugging tools instead.
`Path`	`downloadsPath`	If specified, accepted downloads are downloaded into this directory.
`Map<String,String>`	`env`	Specify environment variables that will be visible to the browser.
`Path`	`executablePath`	Path to a browser executable to run instead of the bundled one.
`Map<String,String>`	`extraHTTPHeaders`	An object containing additional HTTP headers to be sent with every request.
`Map<String,Object>`	`firefoxUserPrefs`	Firefox user preferences.
`Optional<ForcedColors>`	`forcedColors`	Emulates `"forced-colors"` media feature, supported values are `"active"`, `"none"`.
`Geolocation`	`geolocation`
`Boolean`	`handleSIGHUP`	Close the browser process on SIGHUP.
`Boolean`	`handleSIGINT`	Close the browser process on Ctrl-C.
`Boolean`	`handleSIGTERM`	Close the browser process on SIGTERM.
`Boolean`	`hasTouch`	Specifies if viewport supports touch events.
`Boolean`	`headless`	Whether to run browser in headless mode.
`HttpCredentials`	`httpCredentials`	Credentials for HTTP authentication.
`Boolean`	`ignoreAllDefaultArgs`	If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`.
`List<String>`	`ignoreDefaultArgs`	If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`.
`Boolean`	`ignoreHTTPSErrors`	Whether to ignore HTTPS errors when sending network requests.
`Boolean`	`isMobile`	Whether the `meta viewport` tag is taken into account and touch events are enabled.
`Boolean`	`javaScriptEnabled`	Whether or not to enable JavaScript in the context.
`String`	`locale`	Specify user locale, for example `en-GB`, `de-DE`, etc.
`Boolean`	`offline`	Whether to emulate network being offline.
`List<String>`	`permissions`	A list of permissions to grant to all pages in this context.
`Proxy`	`proxy`	Network proxy settings.
`HarContentPolicy`	`recordHarContent`	Optional setting to control resource content management.
`HarMode`	`recordHarMode`	When set to `minimal`, only record information necessary for routing from HAR.
`Boolean`	`recordHarOmitContent`	Optional setting to control whether to omit request content from the HAR.
`Path`	`recordHarPath`	Enables HAR recording for all pages into the specified HAR file on the filesystem.
`Object`	`recordHarUrlFilter`
`Path`	`recordVideoDir`	Enables video recording for all pages into the specified directory.
`RecordVideoSize`	`recordVideoSize`	Dimensions of the recorded videos.
`Optional<ReducedMotion>`	`reducedMotion`	Emulates `"prefers-reduced-motion"` media feature, supported values are `"reduce"`, `"no-preference"`.
`ScreenSize`	`screenSize`	Emulates consistent window screen size available inside web page via `window.screen`.
`ServiceWorkerPolicy`	`serviceWorkers`	Whether to allow sites to register Service workers.
`Double`	`slowMo`	Slows down Playwright operations by the specified amount of milliseconds.
`Boolean`	`strictSelectors`	If set to true, enables strict selectors mode for this context.
`Double`	`timeout`	Maximum time in milliseconds to wait for the browser instance to start.
`String`	`timezoneId`	Changes the timezone of the context.
`Path`	`tracesDir`	If specified, traces are saved into this directory.
`String`	`userAgent`	Specific user agent to use in this context.
`Optional<ViewportSize>`	`viewportSize`	Emulates consistent viewport for each page.

Constructor Summary

Constructors
Constructor Description

LaunchPersistentContextOptions()

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`BrowserType.LaunchPersistentContextOptions`	`setAcceptDownloads(boolean acceptDownloads)`	Whether to automatically download all the attachments.
`BrowserType.LaunchPersistentContextOptions`	`setArgs(List<String> args)`	NOTE: Use custom browser args at your own risk, as some of them may break Playwright functionality.
`BrowserType.LaunchPersistentContextOptions`	`setBaseURL(String baseURL)`	When using `Page.navigate()`, `Page.route()`, `Page.waitForURL()`, `Page.waitForRequest()`, or `Page.waitForResponse()` it takes the base URL in consideration by using the `URL()` constructor for building the corresponding URL.
`BrowserType.LaunchPersistentContextOptions`	`setBypassCSP(boolean bypassCSP)`	Toggles bypassing page's Content-Security-Policy.
`BrowserType.LaunchPersistentContextOptions`	`setChannel(BrowserChannel channel)`	Deprecated.
`BrowserType.LaunchPersistentContextOptions`	`setChannel(String channel)`	Browser distribution channel.
`BrowserType.LaunchPersistentContextOptions`	`setChromiumSandbox(boolean chromiumSandbox)`	Enable Chromium sandboxing.
`BrowserType.LaunchPersistentContextOptions`	`setColorScheme(ColorScheme colorScheme)`	Emulates `"prefers-colors-scheme"` media feature, supported values are `"light"`, `"dark"`, `"no-preference"`.
`BrowserType.LaunchPersistentContextOptions`	`setDeviceScaleFactor(double deviceScaleFactor)`	Specify device scale factor (can be thought of as dpr).
`BrowserType.LaunchPersistentContextOptions`	`setDevtools(boolean devtools)`	Deprecated. Use debugging tools instead.
`BrowserType.LaunchPersistentContextOptions`	`setDownloadsPath(Path downloadsPath)`	If specified, accepted downloads are downloaded into this directory.
`BrowserType.LaunchPersistentContextOptions`	`setEnv(Map<String,String> env)`	Specify environment variables that will be visible to the browser.
`BrowserType.LaunchPersistentContextOptions`	`setExecutablePath(Path executablePath)`	Path to a browser executable to run instead of the bundled one.
`BrowserType.LaunchPersistentContextOptions`	`setExtraHTTPHeaders(Map<String,String> extraHTTPHeaders)`	An object containing additional HTTP headers to be sent with every request.
`BrowserType.LaunchPersistentContextOptions`	`setFirefoxUserPrefs(Map<String,Object> firefoxUserPrefs)`	Firefox user preferences.
`BrowserType.LaunchPersistentContextOptions`	`setForcedColors(ForcedColors forcedColors)`	Emulates `"forced-colors"` media feature, supported values are `"active"`, `"none"`.
`BrowserType.LaunchPersistentContextOptions`	`setGeolocation(double latitude, double longitude)`
`BrowserType.LaunchPersistentContextOptions`	`setGeolocation(Geolocation geolocation)`
`BrowserType.LaunchPersistentContextOptions`	`setHandleSIGHUP(boolean handleSIGHUP)`	Close the browser process on SIGHUP.
`BrowserType.LaunchPersistentContextOptions`	`setHandleSIGINT(boolean handleSIGINT)`	Close the browser process on Ctrl-C.
`BrowserType.LaunchPersistentContextOptions`	`setHandleSIGTERM(boolean handleSIGTERM)`	Close the browser process on SIGTERM.
`BrowserType.LaunchPersistentContextOptions`	`setHasTouch(boolean hasTouch)`	Specifies if viewport supports touch events.
`BrowserType.LaunchPersistentContextOptions`	`setHeadless(boolean headless)`	Whether to run browser in headless mode.
`BrowserType.LaunchPersistentContextOptions`	`setHttpCredentials(HttpCredentials httpCredentials)`	Credentials for HTTP authentication.
`BrowserType.LaunchPersistentContextOptions`	`setHttpCredentials(String username, String password)`	Credentials for HTTP authentication.
`BrowserType.LaunchPersistentContextOptions`	`setIgnoreAllDefaultArgs(boolean ignoreAllDefaultArgs)`	If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`.
`BrowserType.LaunchPersistentContextOptions`	`setIgnoreDefaultArgs(List<String> ignoreDefaultArgs)`	If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`.
`BrowserType.LaunchPersistentContextOptions`	`setIgnoreHTTPSErrors(boolean ignoreHTTPSErrors)`	Whether to ignore HTTPS errors when sending network requests.
`BrowserType.LaunchPersistentContextOptions`	`setIsMobile(boolean isMobile)`	Whether the `meta viewport` tag is taken into account and touch events are enabled.
`BrowserType.LaunchPersistentContextOptions`	`setJavaScriptEnabled(boolean javaScriptEnabled)`	Whether or not to enable JavaScript in the context.
`BrowserType.LaunchPersistentContextOptions`	`setLocale(String locale)`	Specify user locale, for example `en-GB`, `de-DE`, etc.
`BrowserType.LaunchPersistentContextOptions`	`setOffline(boolean offline)`	Whether to emulate network being offline.
`BrowserType.LaunchPersistentContextOptions`	`setPermissions(List<String> permissions)`	A list of permissions to grant to all pages in this context.
`BrowserType.LaunchPersistentContextOptions`	`setProxy(Proxy proxy)`	Network proxy settings.
`BrowserType.LaunchPersistentContextOptions`	`setProxy(String server)`	Network proxy settings.
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarContent(HarContentPolicy recordHarContent)`	Optional setting to control resource content management.
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarMode(HarMode recordHarMode)`	When set to `minimal`, only record information necessary for routing from HAR.
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarOmitContent(boolean recordHarOmitContent)`	Optional setting to control whether to omit request content from the HAR.
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarPath(Path recordHarPath)`	Enables HAR recording for all pages into the specified HAR file on the filesystem.
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarUrlFilter(String recordHarUrlFilter)`
`BrowserType.LaunchPersistentContextOptions`	`setRecordHarUrlFilter(Pattern recordHarUrlFilter)`
`BrowserType.LaunchPersistentContextOptions`	`setRecordVideoDir(Path recordVideoDir)`	Enables video recording for all pages into the specified directory.
`BrowserType.LaunchPersistentContextOptions`	`setRecordVideoSize(int width, int height)`	Dimensions of the recorded videos.
`BrowserType.LaunchPersistentContextOptions`	`setRecordVideoSize(RecordVideoSize recordVideoSize)`	Dimensions of the recorded videos.
`BrowserType.LaunchPersistentContextOptions`	`setReducedMotion(ReducedMotion reducedMotion)`	Emulates `"prefers-reduced-motion"` media feature, supported values are `"reduce"`, `"no-preference"`.
`BrowserType.LaunchPersistentContextOptions`	`setScreenSize(int width, int height)`	Emulates consistent window screen size available inside web page via `window.screen`.
`BrowserType.LaunchPersistentContextOptions`	`setScreenSize(ScreenSize screenSize)`	Emulates consistent window screen size available inside web page via `window.screen`.
`BrowserType.LaunchPersistentContextOptions`	`setServiceWorkers(ServiceWorkerPolicy serviceWorkers)`	Whether to allow sites to register Service workers.
`BrowserType.LaunchPersistentContextOptions`	`setSlowMo(double slowMo)`	Slows down Playwright operations by the specified amount of milliseconds.
`BrowserType.LaunchPersistentContextOptions`	`setStrictSelectors(boolean strictSelectors)`	If set to true, enables strict selectors mode for this context.
`BrowserType.LaunchPersistentContextOptions`	`setTimeout(double timeout)`	Maximum time in milliseconds to wait for the browser instance to start.
`BrowserType.LaunchPersistentContextOptions`	`setTimezoneId(String timezoneId)`	Changes the timezone of the context.
`BrowserType.LaunchPersistentContextOptions`	`setTracesDir(Path tracesDir)`	If specified, traces are saved into this directory.
`BrowserType.LaunchPersistentContextOptions`	`setUserAgent(String userAgent)`	Specific user agent to use in this context.
`BrowserType.LaunchPersistentContextOptions`	`setViewportSize(int width, int height)`	Emulates consistent viewport for each page.
`BrowserType.LaunchPersistentContextOptions`	`setViewportSize(ViewportSize viewportSize)`	Emulates consistent viewport for each page.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - acceptDownloads
```
public Boolean acceptDownloads
```
    Whether to automatically download all the attachments. Defaults to true where all the downloads are accepted.
  - args
```
public List<String> args
```
    NOTE: Use custom browser args at your own risk, as some of them may break Playwright functionality.
    Additional arguments to pass to the browser instance. The list of Chromium flags can be found here.
  - baseURL
```
public String baseURL
```
    When using Page.navigate(), Page.route(), Page.waitForURL(), Page.waitForRequest(), or Page.waitForResponse() it takes the base URL in consideration by using the URL() constructor for building the corresponding URL. Unset by default. Examples:
    
    baseURL: http://localhost:3000 and navigating to /bar.html results in http://localhost:3000/bar.html
    
    baseURL: http://localhost:3000/foo/ and navigating to ./bar.html results in http://localhost:3000/foo/bar.html
    
    baseURL: http://localhost:3000/foo (without trailing slash) and navigating to ./bar.html results in http://localhost:3000/bar.html
  - bypassCSP
```
public Boolean bypassCSP
```
    Toggles bypassing page's Content-Security-Policy. Defaults to false.
  - channel
```
public Object channel
```
    Browser distribution channel. Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using Google Chrome and Microsoft Edge.
  - chromiumSandbox
```
public Boolean chromiumSandbox
```
    Enable Chromium sandboxing. Defaults to false.
  - colorScheme
```
public Optional<ColorScheme> colorScheme
```
    Emulates "prefers-colors-scheme" media feature, supported values are "light", "dark", "no-preference". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "light".
  - deviceScaleFactor
```
public Double deviceScaleFactor
```
    Specify device scale factor (can be thought of as dpr). Defaults to 1. Learn more about emulating devices with device scale factor.
  - devtools
```
public Boolean devtools
```
    Deprecated.
    Use debugging tools instead.
  - downloadsPath
```
public Path downloadsPath
```
    If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed.
  - env
```
public Map<String,String> env
```
    Specify environment variables that will be visible to the browser. Defaults to process.env.
  - executablePath
```
public Path executablePath
```
    Path to a browser executable to run instead of the bundled one. If executablePath is a relative path, then it is resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox or WebKit, use at your own risk.
  - extraHTTPHeaders
```
public Map<String,String> extraHTTPHeaders
```
    An object containing additional HTTP headers to be sent with every request. Defaults to none.
  - firefoxUserPrefs
```
public Map<String,Object> firefoxUserPrefs
```
    Firefox user preferences. Learn more about the Firefox user preferences at about:config.
  - forcedColors
```
public Optional<ForcedColors> forcedColors
```
    Emulates "forced-colors" media feature, supported values are "active", "none". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "none".
  - geolocation
```
public Geolocation geolocation
```
  - handleSIGHUP
```
public Boolean handleSIGHUP
```
    Close the browser process on SIGHUP. Defaults to true.
  - handleSIGINT
```
public Boolean handleSIGINT
```
    Close the browser process on Ctrl-C. Defaults to true.
  - handleSIGTERM
```
public Boolean handleSIGTERM
```
    Close the browser process on SIGTERM. Defaults to true.
  - hasTouch
```
public Boolean hasTouch
```
    Specifies if viewport supports touch events. Defaults to false. Learn more about mobile emulation.
  - headless
```
public Boolean headless
```
    Whether to run browser in headless mode. More details for Chromium and Firefox. Defaults to true unless the devtools option is true.
  - httpCredentials
```
public HttpCredentials httpCredentials
```
    Credentials for HTTP authentication. If no origin is specified, the username and password are sent to any servers upon unauthorized responses.
  - ignoreAllDefaultArgs
```
public Boolean ignoreAllDefaultArgs
```
    If true, Playwright does not pass its own configurations args and only uses the ones from args. Dangerous option; use with care. Defaults to false.
  - ignoreDefaultArgs
```
public List<String> ignoreDefaultArgs
```
    If true, Playwright does not pass its own configurations args and only uses the ones from args. Dangerous option; use with care.
  - ignoreHTTPSErrors
```
public Boolean ignoreHTTPSErrors
```
    Whether to ignore HTTPS errors when sending network requests. Defaults to false.
  - isMobile
```
public Boolean isMobile
```
    Whether the meta viewport tag is taken into account and touch events are enabled. isMobile is a part of device, so you don't actually need to set it manually. Defaults to false and is not supported in Firefox. Learn more about mobile emulation.
  - javaScriptEnabled
```
public Boolean javaScriptEnabled
```
    Whether or not to enable JavaScript in the context. Defaults to true. Learn more about disabling JavaScript.
  - locale
```
public String locale
```
    Specify user locale, for example en-GB, de-DE, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our emulation guide.
  - offline
```
public Boolean offline
```
    Whether to emulate network being offline. Defaults to false. Learn more about network emulation.
  - permissions
```
public List<String> permissions
```
    A list of permissions to grant to all pages in this context. See BrowserContext.grantPermissions() for more details. Defaults to none.
  - proxy
```
public Proxy proxy
```
    Network proxy settings.
  - recordHarContent
```
public HarContentPolicy recordHarContent
```
    Optional setting to control resource content management. If omit is specified, content is not persisted. If attach is specified, resources are persisted as separate files and all of these files are archived along with the HAR file. Defaults to embed, which stores content inline the HAR file as per HAR specification.
  - recordHarMode
```
public HarMode recordHarMode
```
    When set to minimal, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to full.
  - recordHarOmitContent
```
public Boolean recordHarOmitContent
```
    Optional setting to control whether to omit request content from the HAR. Defaults to false.
  - recordHarPath
```
public Path recordHarPath
```
    Enables HAR recording for all pages into the specified HAR file on the filesystem. If not specified, the HAR is not recorded. Make sure to call BrowserContext.close() for the HAR to be saved.
  - recordHarUrlFilter
```
public Object recordHarUrlFilter
```
  - recordVideoDir
```
public Path recordVideoDir
```
    Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure to call BrowserContext.close() for videos to be saved.
  - recordVideoSize
```
public RecordVideoSize recordVideoSize
```
    Dimensions of the recorded videos. If not specified the size will be equal to viewport scaled down to fit into 800x800. If viewport is not configured explicitly the video size defaults to 800x450. Actual picture of each page will be scaled down if necessary to fit the specified size.
  - reducedMotion
```
public Optional<ReducedMotion> reducedMotion
```
    Emulates "prefers-reduced-motion" media feature, supported values are "reduce", "no-preference". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "no-preference".
  - screenSize
```
public ScreenSize screenSize
```
    Emulates consistent window screen size available inside web page via window.screen. Is only used when the viewport is set.
  - serviceWorkers
```
public ServiceWorkerPolicy serviceWorkers
```
    Whether to allow sites to register Service workers. Defaults to "allow".
    
    "allow": Service Workers can be registered.
    
    "block": Playwright will block all registration of Service Workers.
  - slowMo
```
public Double slowMo
```
    Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
  - strictSelectors
```
public Boolean strictSelectors
```
    If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors that imply single target DOM element will throw when more than one element matches the selector. This option does not affect any Locator APIs (Locators are always strict). Defaults to false. See Locator to learn more about the strict mode.
  - timeout
```
public Double timeout
```
    Maximum time in milliseconds to wait for the browser instance to start. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
  - timezoneId
```
public String timezoneId
```
    Changes the timezone of the context. See ICU's metaZones.txt for a list of supported timezone IDs. Defaults to the system timezone.
  - tracesDir
```
public Path tracesDir
```
    If specified, traces are saved into this directory.
  - userAgent
```
public String userAgent
```
    Specific user agent to use in this context.
  - viewportSize
```
public Optional<ViewportSize> viewportSize
```
    Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use null to disable the consistent viewport emulation. Learn more about viewport emulation.
    NOTE: The null value opts out from the default presets, makes viewport depend on the host window size defined by the operating system. It makes the execution of the tests non-deterministic.
- Constructor Detail
  - LaunchPersistentContextOptions
```
public LaunchPersistentContextOptions()
```
- Method Detail
  - setAcceptDownloads
```
public BrowserType.LaunchPersistentContextOptions setAcceptDownloads(boolean acceptDownloads)
```
    Whether to automatically download all the attachments. Defaults to true where all the downloads are accepted.
  - setArgs
```
public BrowserType.LaunchPersistentContextOptions setArgs(List<String> args)
```
    NOTE: Use custom browser args at your own risk, as some of them may break Playwright functionality.
    Additional arguments to pass to the browser instance. The list of Chromium flags can be found here.
  - setBaseURL
```
public BrowserType.LaunchPersistentContextOptions setBaseURL(String baseURL)
```
    When using Page.navigate(), Page.route(), Page.waitForURL(), Page.waitForRequest(), or Page.waitForResponse() it takes the base URL in consideration by using the URL() constructor for building the corresponding URL. Unset by default. Examples:
    
    baseURL: http://localhost:3000 and navigating to /bar.html results in http://localhost:3000/bar.html
    
    baseURL: http://localhost:3000/foo/ and navigating to ./bar.html results in http://localhost:3000/foo/bar.html
    
    baseURL: http://localhost:3000/foo (without trailing slash) and navigating to ./bar.html results in http://localhost:3000/bar.html
  - setBypassCSP
```
public BrowserType.LaunchPersistentContextOptions setBypassCSP(boolean bypassCSP)
```
    Toggles bypassing page's Content-Security-Policy. Defaults to false.
  - setChannel
```
@Deprecated
public BrowserType.LaunchPersistentContextOptions setChannel(BrowserChannel channel)
```
    Deprecated.
  - setChannel
```
public BrowserType.LaunchPersistentContextOptions setChannel(String channel)
```
    Browser distribution channel. Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using Google Chrome and Microsoft Edge.
  - setChromiumSandbox
```
public BrowserType.LaunchPersistentContextOptions setChromiumSandbox(boolean chromiumSandbox)
```
    Enable Chromium sandboxing. Defaults to false.
  - setColorScheme
```
public BrowserType.LaunchPersistentContextOptions setColorScheme(ColorScheme colorScheme)
```
    Emulates "prefers-colors-scheme" media feature, supported values are "light", "dark", "no-preference". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "light".
  - setDeviceScaleFactor
```
public BrowserType.LaunchPersistentContextOptions setDeviceScaleFactor(double deviceScaleFactor)
```
    Specify device scale factor (can be thought of as dpr). Defaults to 1. Learn more about emulating devices with device scale factor.
  - setDevtools
```
public BrowserType.LaunchPersistentContextOptions setDevtools(boolean devtools)
```
    Deprecated.
    Use debugging tools instead.
  - setDownloadsPath
```
public BrowserType.LaunchPersistentContextOptions setDownloadsPath(Path downloadsPath)
```
    If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed.
  - setEnv
```
public BrowserType.LaunchPersistentContextOptions setEnv(Map<String,String> env)
```
    Specify environment variables that will be visible to the browser. Defaults to process.env.
  - setExecutablePath
```
public BrowserType.LaunchPersistentContextOptions setExecutablePath(Path executablePath)
```
    Path to a browser executable to run instead of the bundled one. If executablePath is a relative path, then it is resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox or WebKit, use at your own risk.
  - setExtraHTTPHeaders
```
public BrowserType.LaunchPersistentContextOptions setExtraHTTPHeaders(Map<String,String> extraHTTPHeaders)
```
    An object containing additional HTTP headers to be sent with every request. Defaults to none.
  - setFirefoxUserPrefs
```
public BrowserType.LaunchPersistentContextOptions setFirefoxUserPrefs(Map<String,Object> firefoxUserPrefs)
```
    Firefox user preferences. Learn more about the Firefox user preferences at about:config.
  - setForcedColors
```
public BrowserType.LaunchPersistentContextOptions setForcedColors(ForcedColors forcedColors)
```
    Emulates "forced-colors" media feature, supported values are "active", "none". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "none".
  - setGeolocation
```
public BrowserType.LaunchPersistentContextOptions setGeolocation(double latitude,
                                                                 double longitude)
```
  - setGeolocation
```
public BrowserType.LaunchPersistentContextOptions setGeolocation(Geolocation geolocation)
```
  - setHandleSIGHUP
```
public BrowserType.LaunchPersistentContextOptions setHandleSIGHUP(boolean handleSIGHUP)
```
    Close the browser process on SIGHUP. Defaults to true.
  - setHandleSIGINT
```
public BrowserType.LaunchPersistentContextOptions setHandleSIGINT(boolean handleSIGINT)
```
    Close the browser process on Ctrl-C. Defaults to true.
  - setHandleSIGTERM
```
public BrowserType.LaunchPersistentContextOptions setHandleSIGTERM(boolean handleSIGTERM)
```
    Close the browser process on SIGTERM. Defaults to true.
  - setHasTouch
```
public BrowserType.LaunchPersistentContextOptions setHasTouch(boolean hasTouch)
```
    Specifies if viewport supports touch events. Defaults to false. Learn more about mobile emulation.
  - setHeadless
```
public BrowserType.LaunchPersistentContextOptions setHeadless(boolean headless)
```
    Whether to run browser in headless mode. More details for Chromium and Firefox. Defaults to true unless the devtools option is true.
  - setHttpCredentials
```
public BrowserType.LaunchPersistentContextOptions setHttpCredentials(String username,
                                                                     String password)
```
    Credentials for HTTP authentication. If no origin is specified, the username and password are sent to any servers upon unauthorized responses.
  - setHttpCredentials
```
public BrowserType.LaunchPersistentContextOptions setHttpCredentials(HttpCredentials httpCredentials)
```
    Credentials for HTTP authentication. If no origin is specified, the username and password are sent to any servers upon unauthorized responses.
  - setIgnoreAllDefaultArgs
```
public BrowserType.LaunchPersistentContextOptions setIgnoreAllDefaultArgs(boolean ignoreAllDefaultArgs)
```
    If true, Playwright does not pass its own configurations args and only uses the ones from args. Dangerous option; use with care. Defaults to false.
  - setIgnoreDefaultArgs
```
public BrowserType.LaunchPersistentContextOptions setIgnoreDefaultArgs(List<String> ignoreDefaultArgs)
```
    If true, Playwright does not pass its own configurations args and only uses the ones from args. Dangerous option; use with care.
  - setIgnoreHTTPSErrors
```
public BrowserType.LaunchPersistentContextOptions setIgnoreHTTPSErrors(boolean ignoreHTTPSErrors)
```
    Whether to ignore HTTPS errors when sending network requests. Defaults to false.
  - setIsMobile
```
public BrowserType.LaunchPersistentContextOptions setIsMobile(boolean isMobile)
```
    Whether the meta viewport tag is taken into account and touch events are enabled. isMobile is a part of device, so you don't actually need to set it manually. Defaults to false and is not supported in Firefox. Learn more about mobile emulation.
  - setJavaScriptEnabled
```
public BrowserType.LaunchPersistentContextOptions setJavaScriptEnabled(boolean javaScriptEnabled)
```
    Whether or not to enable JavaScript in the context. Defaults to true. Learn more about disabling JavaScript.
  - setLocale
```
public BrowserType.LaunchPersistentContextOptions setLocale(String locale)
```
    Specify user locale, for example en-GB, de-DE, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting rules. Defaults to the system default locale. Learn more about emulation in our emulation guide.
  - setOffline
```
public BrowserType.LaunchPersistentContextOptions setOffline(boolean offline)
```
    Whether to emulate network being offline. Defaults to false. Learn more about network emulation.
  - setPermissions
```
public BrowserType.LaunchPersistentContextOptions setPermissions(List<String> permissions)
```
    A list of permissions to grant to all pages in this context. See BrowserContext.grantPermissions() for more details. Defaults to none.
  - setProxy
```
public BrowserType.LaunchPersistentContextOptions setProxy(String server)
```
    Network proxy settings.
  - setProxy
```
public BrowserType.LaunchPersistentContextOptions setProxy(Proxy proxy)
```
    Network proxy settings.
  - setRecordHarContent
```
public BrowserType.LaunchPersistentContextOptions setRecordHarContent(HarContentPolicy recordHarContent)
```
    Optional setting to control resource content management. If omit is specified, content is not persisted. If attach is specified, resources are persisted as separate files and all of these files are archived along with the HAR file. Defaults to embed, which stores content inline the HAR file as per HAR specification.
  - setRecordHarMode
```
public BrowserType.LaunchPersistentContextOptions setRecordHarMode(HarMode recordHarMode)
```
    When set to minimal, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to full.
  - setRecordHarOmitContent
```
public BrowserType.LaunchPersistentContextOptions setRecordHarOmitContent(boolean recordHarOmitContent)
```
    Optional setting to control whether to omit request content from the HAR. Defaults to false.
  - setRecordHarPath
```
public BrowserType.LaunchPersistentContextOptions setRecordHarPath(Path recordHarPath)
```
    Enables HAR recording for all pages into the specified HAR file on the filesystem. If not specified, the HAR is not recorded. Make sure to call BrowserContext.close() for the HAR to be saved.
  - setRecordHarUrlFilter
```
public BrowserType.LaunchPersistentContextOptions setRecordHarUrlFilter(String recordHarUrlFilter)
```
  - setRecordHarUrlFilter
```
public BrowserType.LaunchPersistentContextOptions setRecordHarUrlFilter(Pattern recordHarUrlFilter)
```
  - setRecordVideoDir
```
public BrowserType.LaunchPersistentContextOptions setRecordVideoDir(Path recordVideoDir)
```
    Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure to call BrowserContext.close() for videos to be saved.
  - setRecordVideoSize
```
public BrowserType.LaunchPersistentContextOptions setRecordVideoSize(int width,
                                                                     int height)
```
    Dimensions of the recorded videos. If not specified the size will be equal to viewport scaled down to fit into 800x800. If viewport is not configured explicitly the video size defaults to 800x450. Actual picture of each page will be scaled down if necessary to fit the specified size.
  - setRecordVideoSize
```
public BrowserType.LaunchPersistentContextOptions setRecordVideoSize(RecordVideoSize recordVideoSize)
```
    Dimensions of the recorded videos. If not specified the size will be equal to viewport scaled down to fit into 800x800. If viewport is not configured explicitly the video size defaults to 800x450. Actual picture of each page will be scaled down if necessary to fit the specified size.
  - setReducedMotion
```
public BrowserType.LaunchPersistentContextOptions setReducedMotion(ReducedMotion reducedMotion)
```
    Emulates "prefers-reduced-motion" media feature, supported values are "reduce", "no-preference". See Page.emulateMedia() for more details. Passing null resets emulation to system defaults. Defaults to "no-preference".
  - setScreenSize
```
public BrowserType.LaunchPersistentContextOptions setScreenSize(int width,
                                                                int height)
```
    Emulates consistent window screen size available inside web page via window.screen. Is only used when the viewport is set.
  - setScreenSize
```
public BrowserType.LaunchPersistentContextOptions setScreenSize(ScreenSize screenSize)
```
    Emulates consistent window screen size available inside web page via window.screen. Is only used when the viewport is set.
  - setServiceWorkers
```
public BrowserType.LaunchPersistentContextOptions setServiceWorkers(ServiceWorkerPolicy serviceWorkers)
```
    Whether to allow sites to register Service workers. Defaults to "allow".
    
    "allow": Service Workers can be registered.
    
    "block": Playwright will block all registration of Service Workers.
  - setSlowMo
```
public BrowserType.LaunchPersistentContextOptions setSlowMo(double slowMo)
```
    Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
  - setStrictSelectors
```
public BrowserType.LaunchPersistentContextOptions setStrictSelectors(boolean strictSelectors)
```
    If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors that imply single target DOM element will throw when more than one element matches the selector. This option does not affect any Locator APIs (Locators are always strict). Defaults to false. See Locator to learn more about the strict mode.
  - setTimeout
```
public BrowserType.LaunchPersistentContextOptions setTimeout(double timeout)
```
    Maximum time in milliseconds to wait for the browser instance to start. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
  - setTimezoneId
```
public BrowserType.LaunchPersistentContextOptions setTimezoneId(String timezoneId)
```
    Changes the timezone of the context. See ICU's metaZones.txt for a list of supported timezone IDs. Defaults to the system timezone.
  - setTracesDir
```
public BrowserType.LaunchPersistentContextOptions setTracesDir(Path tracesDir)
```
    If specified, traces are saved into this directory.
  - setUserAgent
```
public BrowserType.LaunchPersistentContextOptions setUserAgent(String userAgent)
```
    Specific user agent to use in this context.
  - setViewportSize
```
public BrowserType.LaunchPersistentContextOptions setViewportSize(int width,
                                                                  int height)
```
    Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use null to disable the consistent viewport emulation. Learn more about viewport emulation.
    NOTE: The null value opts out from the default presets, makes viewport depend on the host window size defined by the operating system. It makes the execution of the tests non-deterministic.
  - setViewportSize
```
public BrowserType.LaunchPersistentContextOptions setViewportSize(ViewportSize viewportSize)
```
    Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use null to disable the consistent viewport emulation. Learn more about viewport emulation.
    NOTE: The null value opts out from the default presets, makes viewport depend on the host window size defined by the operating system. It makes the execution of the tests non-deterministic.

Class BrowserType.LaunchPersistentContextOptions

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

acceptDownloads

args

baseURL

bypassCSP

channel

chromiumSandbox

colorScheme

deviceScaleFactor

devtools

downloadsPath

env

executablePath

extraHTTPHeaders

firefoxUserPrefs

forcedColors

geolocation

handleSIGHUP

handleSIGINT

handleSIGTERM

hasTouch

headless

httpCredentials

ignoreAllDefaultArgs

ignoreDefaultArgs

ignoreHTTPSErrors

isMobile

javaScriptEnabled

locale

offline

permissions

proxy

recordHarContent

recordHarMode

recordHarOmitContent

recordHarPath

recordHarUrlFilter

recordVideoDir

recordVideoSize

reducedMotion

screenSize

serviceWorkers

slowMo

strictSelectors

timeout

timezoneId

tracesDir

userAgent

viewportSize

Constructor Detail

LaunchPersistentContextOptions

Method Detail

setAcceptDownloads

setArgs

setBaseURL

setBypassCSP

setChannel

setChannel

setChromiumSandbox

setColorScheme

setDeviceScaleFactor

setDevtools

setDownloadsPath

setEnv

setExecutablePath

setExtraHTTPHeaders

setFirefoxUserPrefs

setForcedColors

setGeolocation

setGeolocation

setHandleSIGHUP

setHandleSIGINT

setHandleSIGTERM

setHasTouch

setHeadless