@@ -414,7 +414,8 @@ class LaunchPersistentContextOptions {
414414 */
415415 public Optional <ColorScheme > colorScheme ;
416416 /**
417- * Specify device scale factor (can be thought of as dpr). Defaults to {@code 1}.
417+ * Specify device scale factor (can be thought of as dpr). Defaults to {@code 1}. Learn more about <a
418+ * href="https://playwright.dev/java/docs/emulation#devices">emulating devices with device scale factor</a>.
418419 */
419420 public Double deviceScaleFactor ;
420421 /**
@@ -462,7 +463,8 @@ class LaunchPersistentContextOptions {
462463 */
463464 public Boolean handleSIGTERM ;
464465 /**
465- * Specifies if viewport supports touch events. Defaults to false.
466+ * Specifies if viewport supports touch events. Defaults to false. Learn more about <a
467+ * href="https://playwright.dev/java/docs/emulation#devices">mobile emulation</a>.
466468 */
467469 public Boolean hasTouch ;
468470 /**
@@ -492,21 +494,25 @@ class LaunchPersistentContextOptions {
492494 */
493495 public Boolean ignoreHTTPSErrors ;
494496 /**
495- * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. Defaults to {@code false}. Not
496- * supported in Firefox.
497+ * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
498+ * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
499+ * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
497500 */
498501 public Boolean isMobile ;
499502 /**
500- * Whether or not to enable JavaScript in the context. Defaults to {@code true}.
503+ * Whether or not to enable JavaScript in the context. Defaults to {@code true}. Learn more about <a
504+ * href="https://playwright.dev/java/docs/emulation#javascript-enabled">disabling JavaScript</a>.
501505 */
502506 public Boolean javaScriptEnabled ;
503507 /**
504508 * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
505- * {@code Accept-Language} request header value as well as number and date formatting rules.
509+ * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
510+ * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
506511 */
507512 public String locale ;
508513 /**
509- * Whether to emulate network being offline. Defaults to {@code false}.
514+ * Whether to emulate network being offline. Defaults to {@code false}. Learn more about <a
515+ * href="https://playwright.dev/java/docs/emulation#offline">network emulation</a>.
510516 */
511517 public Boolean offline ;
512518 /**
@@ -602,8 +608,9 @@ class LaunchPersistentContextOptions {
602608 */
603609 public String userAgent ;
604610 /**
605- * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
606- * viewport emulation.
611+ * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the
612+ * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
613+ * emulation</a>.
607614 *
608615 * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
609616 * operating system. It makes the execution of the tests non-deterministic.
@@ -687,7 +694,8 @@ public LaunchPersistentContextOptions setColorScheme(ColorScheme colorScheme) {
687694 return this ;
688695 }
689696 /**
690- * Specify device scale factor (can be thought of as dpr). Defaults to {@code 1}.
697+ * Specify device scale factor (can be thought of as dpr). Defaults to {@code 1}. Learn more about <a
698+ * href="https://playwright.dev/java/docs/emulation#devices">emulating devices with device scale factor</a>.
691699 */
692700 public LaunchPersistentContextOptions setDeviceScaleFactor (double deviceScaleFactor ) {
693701 this .deviceScaleFactor = deviceScaleFactor ;
@@ -771,7 +779,8 @@ public LaunchPersistentContextOptions setHandleSIGTERM(boolean handleSIGTERM) {
771779 return this ;
772780 }
773781 /**
774- * Specifies if viewport supports touch events. Defaults to false.
782+ * Specifies if viewport supports touch events. Defaults to false. Learn more about <a
783+ * href="https://playwright.dev/java/docs/emulation#devices">mobile emulation</a>.
775784 */
776785 public LaunchPersistentContextOptions setHasTouch (boolean hasTouch ) {
777786 this .hasTouch = hasTouch ;
@@ -826,30 +835,34 @@ public LaunchPersistentContextOptions setIgnoreHTTPSErrors(boolean ignoreHTTPSEr
826835 return this ;
827836 }
828837 /**
829- * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. Defaults to {@code false}. Not
830- * supported in Firefox.
838+ * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
839+ * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
840+ * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
831841 */
832842 public LaunchPersistentContextOptions setIsMobile (boolean isMobile ) {
833843 this .isMobile = isMobile ;
834844 return this ;
835845 }
836846 /**
837- * Whether or not to enable JavaScript in the context. Defaults to {@code true}.
847+ * Whether or not to enable JavaScript in the context. Defaults to {@code true}. Learn more about <a
848+ * href="https://playwright.dev/java/docs/emulation#javascript-enabled">disabling JavaScript</a>.
838849 */
839850 public LaunchPersistentContextOptions setJavaScriptEnabled (boolean javaScriptEnabled ) {
840851 this .javaScriptEnabled = javaScriptEnabled ;
841852 return this ;
842853 }
843854 /**
844855 * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
845- * {@code Accept-Language} request header value as well as number and date formatting rules.
856+ * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
857+ * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
846858 */
847859 public LaunchPersistentContextOptions setLocale (String locale ) {
848860 this .locale = locale ;
849861 return this ;
850862 }
851863 /**
852- * Whether to emulate network being offline. Defaults to {@code false}.
864+ * Whether to emulate network being offline. Defaults to {@code false}. Learn more about <a
865+ * href="https://playwright.dev/java/docs/emulation#offline">network emulation</a>.
853866 */
854867 public LaunchPersistentContextOptions setOffline (boolean offline ) {
855868 this .offline = offline ;
@@ -1027,8 +1040,9 @@ public LaunchPersistentContextOptions setUserAgent(String userAgent) {
10271040 return this ;
10281041 }
10291042 /**
1030- * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
1031- * viewport emulation.
1043+ * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the
1044+ * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
1045+ * emulation</a>.
10321046 *
10331047 * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
10341048 * operating system. It makes the execution of the tests non-deterministic.
@@ -1037,8 +1051,9 @@ public LaunchPersistentContextOptions setViewportSize(int width, int height) {
10371051 return setViewportSize (new ViewportSize (width , height ));
10381052 }
10391053 /**
1040- * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
1041- * viewport emulation.
1054+ * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the
1055+ * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
1056+ * emulation</a>.
10421057 *
10431058 * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
10441059 * operating system. It makes the execution of the tests non-deterministic.
0 commit comments