io.webfolder.cdp.command

Interface Emulation

public interface Emulation

This domain emulates different environments for the page

Method Summary

Modifier and Type	Method and Description
Boolean	canEmulate() Tells whether emulation is supported.
void	clearDeviceMetricsOverride() Clears the overriden device metrics.
void	clearGeolocationOverride() Clears the overriden Geolocation Position and Error.
void	resetPageScaleFactor() Requests that page scale factor is reset to initial values.
void	setCPUThrottlingRate(Double rate) Enables CPU throttling to emulate slow CPUs.
void	setDefaultBackgroundColorOverride() Sets or clears an override of the default background color of the frame.
void	setDefaultBackgroundColorOverride(RGBA color) Sets or clears an override of the default background color of the frame.
void	setDeviceMetricsOverride(Integer width, Integer height, Double deviceScaleFactor, Boolean mobile) 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).
void	setDeviceMetricsOverride(Integer width, Integer height, Double deviceScaleFactor, Boolean mobile, Double scale, Integer screenWidth, Integer screenHeight, Integer positionX, Integer positionY, Boolean dontSetVisibleSize, ScreenOrientation screenOrientation) 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).
void	setEmulatedMedia(String media) Emulates the given media for CSS media queries.
void	setGeolocationOverride() Overrides the Geolocation Position or Error.
void	setGeolocationOverride(Double latitude, Double longitude, Double accuracy) Overrides the Geolocation Position or Error.
void	setPageScaleFactor(Double pageScaleFactor) Sets a specified page scale factor.
void	setScriptExecutionDisabled(Boolean value) Switches script execution in the page.
void	setTouchEmulationEnabled(Boolean enabled) Toggles mouse event-based touch event emulation.
void	setTouchEmulationEnabled(Boolean enabled, Platform configuration) Toggles mouse event-based touch event emulation.
void	setVirtualTimePolicy(VirtualTimePolicy policy) Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets the current virtual time policy.
void	setVirtualTimePolicy(VirtualTimePolicy policy, Integer budget) Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets the current virtual time policy.
void	setVisibleSize(Integer width, Integer height) Resizes the frame/viewport of the page.

Method Detail

setDeviceMetricsOverride

void setDeviceMetricsOverride(Integer width,
                              Integer height,
                              Double deviceScaleFactor,
                              Boolean mobile,
                              Double scale,
                              Integer screenWidth,
                              Integer screenHeight,
                              Integer positionX,
                              Integer positionY,
                              Boolean dontSetVisibleSize,
                              ScreenOrientation screenOrientation)

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).

Parameters:

width - Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.

height - Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.

deviceScaleFactor - Overriding device scale factor value. 0 disables the override.

mobile - Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.

scale - Scale to apply to resulting view image. Ignored in |fitWindow| mode.

screenWidth - Overriding screen width value in pixels (minimum 0, maximum 10000000). Only used for |mobile==true|.

screenHeight - Overriding screen height value in pixels (minimum 0, maximum 10000000). Only used for |mobile==true|.

positionX - Overriding view X position on screen in pixels (minimum 0, maximum 10000000). Only used for |mobile==true|.

positionY - Overriding view Y position on screen in pixels (minimum 0, maximum 10000000). Only used for |mobile==true|.

dontSetVisibleSize - Do not set visible view size, rely upon explicit setVisibleSize call.

screenOrientation - Screen orientation override.

clearDeviceMetricsOverride

void clearDeviceMetricsOverride()

Clears the overriden device metrics.

resetPageScaleFactor

void resetPageScaleFactor()

Requests that page scale factor is reset to initial values.

setPageScaleFactor

void setPageScaleFactor(Double pageScaleFactor)

Sets a specified page scale factor.

Parameters:

pageScaleFactor - Page scale factor.

setVisibleSize

void setVisibleSize(Integer width,
                    Integer height)

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.

Parameters:

width - Frame width (DIP).

height - Frame height (DIP).

setScriptExecutionDisabled

void setScriptExecutionDisabled(Boolean value)

Switches script execution in the page.

Parameters:

value - Whether script execution should be disabled in the page.

setGeolocationOverride

void setGeolocationOverride(Double latitude,
                            Double longitude,
                            Double accuracy)

Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position unavailable.

Parameters:

latitude - Mock latitude

longitude - Mock longitude

accuracy - Mock accuracy

clearGeolocationOverride

void clearGeolocationOverride()

Clears the overriden Geolocation Position and Error.

setTouchEmulationEnabled

void setTouchEmulationEnabled(Boolean enabled,
                              Platform configuration)

Toggles mouse event-based touch event emulation.

Parameters:

enabled - Whether the touch event emulation should be enabled.

configuration - Touch/gesture events configuration. Default: current platform.

setEmulatedMedia

void setEmulatedMedia(String media)

Emulates the given media for CSS media queries.

Parameters:

media - Media type to emulate. Empty string disables the override.

setCPUThrottlingRate

void setCPUThrottlingRate(Double rate)

Enables CPU throttling to emulate slow CPUs.

Parameters:

rate - Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).

canEmulate

Boolean canEmulate()

Tells whether emulation is supported.

Returns:

True if emulation is supported.

setVirtualTimePolicy

void setVirtualTimePolicy(VirtualTimePolicy policy,
                          Integer budget)

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.

Parameters:

budget - If set, after this many virtual milliseconds have elapsed virtual time will be paused and a virtualTimeBudgetExpired event is sent.

setDefaultBackgroundColorOverride

void setDefaultBackgroundColorOverride(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.

Parameters:

color - RGBA of the default background color. If not specified, any existing override will be cleared.

setDeviceMetricsOverride

void setDeviceMetricsOverride(Integer width,
                              Integer height,
                              Double deviceScaleFactor,
                              Boolean mobile)

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).

Parameters:

width - Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.

height - Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.

deviceScaleFactor - Overriding device scale factor value. 0 disables the override.

mobile - Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.

setGeolocationOverride

void setGeolocationOverride()

Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position unavailable.

setTouchEmulationEnabled

void setTouchEmulationEnabled(Boolean enabled)

Toggles mouse event-based touch event emulation.

Parameters:

enabled - Whether the touch event emulation should be enabled.

setVirtualTimePolicy

void setVirtualTimePolicy(VirtualTimePolicy policy)

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.

setDefaultBackgroundColorOverride

void setDefaultBackgroundColorOverride()

Sets or clears an override of the default background color of the frame. This override is used if the content does not specify one.