Package org.openqa.selenium.devtools.emulation

Class Emulation

  • public class Emulation
extends java.lang.Object
    This domain emulates different environments for the page.

    • Constructor Summary

      Constructors 
      Constructor Description
      Emulation()  

    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static Command<java.lang.Boolean> canEmulate()
      Tells whether emulation is supported.
      static Command<java.lang.Void> clearDeviceMetricsOverride()
      Clears the overriden device metrics.
      static Command<java.lang.Void> clearGeolocationOverride()
      Clears the overriden Geolocation Position and Error.
      static Command<java.lang.Void> resetPageScaleFactor()
      Requests that page scale factor is reset to initial values.
      static Command<java.lang.Void> setCPUThrottlingRate​(java.lang.Number rate)
      Enables CPU throttling to emulate slow CPUs.
      static Command<java.lang.Void> setDefaultBackgroundColorOverride​(java.util.Optional<RGBA> color)
      Sets or clears an override of the default background color of the frame.
      static Command<java.lang.Void> setDeviceMetricsOverride​(java.lang.Integer width, java.lang.Integer height, java.lang.Number deviceScaleFactor, java.lang.Boolean mobile, java.util.Optional<java.lang.Number> scale, java.util.Optional<java.lang.Integer> screenWidth, java.util.Optional<java.lang.Integer> screenHeight, java.util.Optional<java.lang.Integer> positionX, java.util.Optional<java.lang.Integer> positionY, java.util.Optional<java.lang.Boolean> dontSetVisibleSize, java.util.Optional<ScreenOrientation> screenOrientation, java.util.Optional<Viewport> viewport)
      Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media query results).
      static Command<java.lang.Void> setDocumentCookieDisabled​(java.lang.Boolean disabled)  
      static Command<java.lang.Void> setEmitTouchEventsForMouse​(java.lang.Boolean enabled, java.util.Optional<Emulation.SetEmitTouchEventsForMouseConfiguration> configuration)  
      static Command<java.lang.Void> setEmulatedMedia​(java.lang.String media)
      Emulates the given media for CSS media queries.
      static Command<java.lang.Void> setFocusEmulationEnabled​(java.lang.Boolean enabled)
      Enables or disables simulating a focused and active page.
      static Command<java.lang.Void> setGeolocationOverride​(java.util.Optional<java.lang.Number> latitude, java.util.Optional<java.lang.Number> longitude, java.util.Optional<java.lang.Number> accuracy)
      Overrides the Geolocation Position or Error.
      static Command<java.lang.Void> setNavigatorOverrides​(java.lang.String platform)
      Deprecated.
      static Command<java.lang.Void> setPageScaleFactor​(java.lang.Number pageScaleFactor)
      Sets a specified page scale factor.
      static Command<java.lang.Void> setScriptExecutionDisabled​(java.lang.Boolean value)
      Switches script execution in the page.
      static Command<java.lang.Void> setScrollbarsHidden​(java.lang.Boolean hidden)  
      static Command<java.lang.Void> setTimezoneOverride​(java.lang.String timezoneId)
      Overrides default host system timezone with the specified one.
      static Command<java.lang.Void> setTouchEmulationEnabled​(java.lang.Boolean enabled, java.util.Optional<java.lang.Integer> maxTouchPoints)
      Enables touch on platforms which do not support them.
      static Command<java.lang.Void> setUserAgentOverride​(java.lang.String userAgent, java.util.Optional<java.lang.String> acceptLanguage, java.util.Optional<java.lang.String> platform)
      Allows overriding user agent with the given string.
      static Command<java.lang.Number> setVirtualTimePolicy​(VirtualTimePolicy policy, java.util.Optional<java.lang.Number> budget, java.util.Optional<java.lang.Integer> maxVirtualTimeTaskStarvationCount, java.util.Optional<java.lang.Boolean> waitForNavigation, java.util.Optional<TimeSinceEpoch> initialVirtualTime)
      Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets the current virtual time policy.
      static Command<java.lang.Void> setVisibleSize​(java.lang.Integer width, java.lang.Integer height)
      Deprecated.
      static Event<java.lang.Void> virtualTimeBudgetExpired()  

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • Emulation

        public Emulation()

    • Method Detail

      • canEmulate

        public static Command<java.lang.Boolean> canEmulate()
        Tells whether emulation is supported.

      • clearDeviceMetricsOverride

        public static Command<java.lang.Void> clearDeviceMetricsOverride()
        Clears the overriden device metrics.

      • clearGeolocationOverride

        public static Command<java.lang.Void> clearGeolocationOverride()
        Clears the overriden Geolocation Position and Error.

      • resetPageScaleFactor

        @Beta
public static Command<java.lang.Void> resetPageScaleFactor()
        Requests that page scale factor is reset to initial values.

      • setFocusEmulationEnabled

        @Beta
public static Command<java.lang.Void> setFocusEmulationEnabled​(java.lang.Boolean enabled)
        Enables or disables simulating a focused and active page.

      • setCPUThrottlingRate

        @Beta
public static Command<java.lang.Void> setCPUThrottlingRate​(java.lang.Number rate)
        Enables CPU throttling to emulate slow CPUs.

      • setDefaultBackgroundColorOverride

        public static Command<java.lang.Void> setDefaultBackgroundColorOverride​(java.util.Optional<RGBA> color)
        Sets or clears an override of the default background color of the frame. This override is used if the content does not specify one.

      • setDeviceMetricsOverride

        public static Command<java.lang.Void> setDeviceMetricsOverride​(java.lang.Integer width,
                                                               java.lang.Integer height,
                                                               java.lang.Number deviceScaleFactor,
                                                               java.lang.Boolean mobile,
                                                               java.util.Optional<java.lang.Number> scale,
                                                               java.util.Optional<java.lang.Integer> screenWidth,
                                                               java.util.Optional<java.lang.Integer> screenHeight,
                                                               java.util.Optional<java.lang.Integer> positionX,
                                                               java.util.Optional<java.lang.Integer> positionY,
                                                               java.util.Optional<java.lang.Boolean> dontSetVisibleSize,
                                                               java.util.Optional<ScreenOrientation> screenOrientation,
                                                               java.util.Optional<Viewport> viewport)
        Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media query results).

      • setScrollbarsHidden

        @Beta
public static Command<java.lang.Void> setScrollbarsHidden​(java.lang.Boolean hidden)

      • setDocumentCookieDisabled

        @Beta
public static Command<java.lang.Void> setDocumentCookieDisabled​(java.lang.Boolean disabled)

      • setEmulatedMedia

        public static Command<java.lang.Void> setEmulatedMedia​(java.lang.String media)
        Emulates the given media for CSS media queries.

      • setGeolocationOverride

        public static Command<java.lang.Void> setGeolocationOverride​(java.util.Optional<java.lang.Number> latitude,
                                                             java.util.Optional<java.lang.Number> longitude,
                                                             java.util.Optional<java.lang.Number> accuracy)
        Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position unavailable.

      • setNavigatorOverrides

        @Beta
@Deprecated
public static Command<java.lang.Void> setNavigatorOverrides​(java.lang.String platform)
        Deprecated.
        Overrides value returned by the javascript navigator object.

      • setPageScaleFactor

        @Beta
public static Command<java.lang.Void> setPageScaleFactor​(java.lang.Number pageScaleFactor)
        Sets a specified page scale factor.

      • setScriptExecutionDisabled

        public static Command<java.lang.Void> setScriptExecutionDisabled​(java.lang.Boolean value)
        Switches script execution in the page.

      • setTouchEmulationEnabled

        public static Command<java.lang.Void> setTouchEmulationEnabled​(java.lang.Boolean enabled,
                                                               java.util.Optional<java.lang.Integer> maxTouchPoints)
        Enables touch on platforms which do not support them.

      • setVirtualTimePolicy

        @Beta
public static Command<java.lang.Number> setVirtualTimePolicy​(VirtualTimePolicy policy,
                                                             java.util.Optional<java.lang.Number> budget,
                                                             java.util.Optional<java.lang.Integer> maxVirtualTimeTaskStarvationCount,
                                                             java.util.Optional<java.lang.Boolean> waitForNavigation,
                                                             java.util.Optional<TimeSinceEpoch> initialVirtualTime)
        Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets the current virtual time policy. Note this supersedes any previous time budget.

      • setTimezoneOverride

        @Beta
public static Command<java.lang.Void> setTimezoneOverride​(java.lang.String timezoneId)
        Overrides default host system timezone with the specified one.

      • setVisibleSize

        @Beta
@Deprecated
public static Command<java.lang.Void> setVisibleSize​(java.lang.Integer width,
                                                     java.lang.Integer height)
        Deprecated.
        Resizes the frame/viewport of the page. Note that this does not affect the frame's container (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported on Android.

      • setUserAgentOverride

        public static Command<java.lang.Void> setUserAgentOverride​(java.lang.String userAgent,
                                                           java.util.Optional<java.lang.String> acceptLanguage,
                                                           java.util.Optional<java.lang.String> platform)
        Allows overriding user agent with the given string.

      • virtualTimeBudgetExpired

        public static Event<java.lang.Void> virtualTimeBudgetExpired()