emulation

DevicePosture dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class DevicePosture:
    #: Current posture of the device
    type_: str

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["type"] = self.type_
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> DevicePosture:
        return cls(
            type_=str(json["type"]),
        )

type_: str instance-attribute

__init__(type_)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> DevicePosture:
    return cls(
        type_=str(json["type"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["type"] = self.type_
    return json

DisabledImageType

Bases: Enum

Enum of image types that can be disabled.

Source code in zendriver/cdp/emulation.py

class DisabledImageType(enum.Enum):
    """
    Enum of image types that can be disabled.
    """

    AVIF = "avif"
    WEBP = "webp"

    def to_json(self) -> str:
        return self.value

    @classmethod
    def from_json(cls, json: str) -> DisabledImageType:
        return cls(json)

AVIF = 'avif' class-attribute instance-attribute

WEBP = 'webp' class-attribute instance-attribute

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: str) -> DisabledImageType:
    return cls(json)

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> str:
    return self.value

DisplayFeature dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class DisplayFeature:
    #: Orientation of a display feature in relation to screen
    orientation: str

    #: The offset from the screen origin in either the x (for vertical
    #: orientation) or y (for horizontal orientation) direction.
    offset: int

    #: A display feature may mask content such that it is not physically
    #: displayed - this length along with the offset describes this area.
    #: A display feature that only splits content will have a 0 mask_length.
    mask_length: int

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["orientation"] = self.orientation
        json["offset"] = self.offset
        json["maskLength"] = self.mask_length
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> DisplayFeature:
        return cls(
            orientation=str(json["orientation"]),
            offset=int(json["offset"]),
            mask_length=int(json["maskLength"]),
        )

mask_length: int instance-attribute

offset: int instance-attribute

orientation: str instance-attribute

__init__(orientation, offset, mask_length)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> DisplayFeature:
    return cls(
        orientation=str(json["orientation"]),
        offset=int(json["offset"]),
        mask_length=int(json["maskLength"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["orientation"] = self.orientation
    json["offset"] = self.offset
    json["maskLength"] = self.mask_length
    return json

MediaFeature dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class MediaFeature:
    name: str

    value: str

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["name"] = self.name
        json["value"] = self.value
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> MediaFeature:
        return cls(
            name=str(json["name"]),
            value=str(json["value"]),
        )

name: str instance-attribute

value: str instance-attribute

__init__(name, value)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> MediaFeature:
    return cls(
        name=str(json["name"]),
        value=str(json["value"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["name"] = self.name
    json["value"] = self.value
    return json

ScreenOrientation dataclass

Screen orientation.

Source code in zendriver/cdp/emulation.py

@dataclass
class ScreenOrientation:
    """
    Screen orientation.
    """

    #: Orientation type.
    type_: str

    #: Orientation angle.
    angle: int

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["type"] = self.type_
        json["angle"] = self.angle
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> ScreenOrientation:
        return cls(
            type_=str(json["type"]),
            angle=int(json["angle"]),
        )

angle: int instance-attribute

type_: str instance-attribute

__init__(type_, angle)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> ScreenOrientation:
    return cls(
        type_=str(json["type"]),
        angle=int(json["angle"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["type"] = self.type_
    json["angle"] = self.angle
    return json

SensorMetadata dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class SensorMetadata:
    available: typing.Optional[bool] = None

    minimum_frequency: typing.Optional[float] = None

    maximum_frequency: typing.Optional[float] = None

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        if self.available is not None:
            json["available"] = self.available
        if self.minimum_frequency is not None:
            json["minimumFrequency"] = self.minimum_frequency
        if self.maximum_frequency is not None:
            json["maximumFrequency"] = self.maximum_frequency
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SensorMetadata:
        return cls(
            available=(
                bool(json["available"])
                if json.get("available", None) is not None
                else None
            ),
            minimum_frequency=(
                float(json["minimumFrequency"])
                if json.get("minimumFrequency", None) is not None
                else None
            ),
            maximum_frequency=(
                float(json["maximumFrequency"])
                if json.get("maximumFrequency", None) is not None
                else None
            ),
        )

available: typing.Optional[bool] = None class-attribute instance-attribute

maximum_frequency: typing.Optional[float] = None class-attribute instance-attribute

minimum_frequency: typing.Optional[float] = None class-attribute instance-attribute

__init__(available=None, minimum_frequency=None, maximum_frequency=None)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> SensorMetadata:
    return cls(
        available=(
            bool(json["available"])
            if json.get("available", None) is not None
            else None
        ),
        minimum_frequency=(
            float(json["minimumFrequency"])
            if json.get("minimumFrequency", None) is not None
            else None
        ),
        maximum_frequency=(
            float(json["maximumFrequency"])
            if json.get("maximumFrequency", None) is not None
            else None
        ),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    if self.available is not None:
        json["available"] = self.available
    if self.minimum_frequency is not None:
        json["minimumFrequency"] = self.minimum_frequency
    if self.maximum_frequency is not None:
        json["maximumFrequency"] = self.maximum_frequency
    return json

SensorReading dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class SensorReading:
    single: typing.Optional[SensorReadingSingle] = None

    xyz: typing.Optional[SensorReadingXYZ] = None

    quaternion: typing.Optional[SensorReadingQuaternion] = None

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        if self.single is not None:
            json["single"] = self.single.to_json()
        if self.xyz is not None:
            json["xyz"] = self.xyz.to_json()
        if self.quaternion is not None:
            json["quaternion"] = self.quaternion.to_json()
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SensorReading:
        return cls(
            single=(
                SensorReadingSingle.from_json(json["single"])
                if json.get("single", None) is not None
                else None
            ),
            xyz=(
                SensorReadingXYZ.from_json(json["xyz"])
                if json.get("xyz", None) is not None
                else None
            ),
            quaternion=(
                SensorReadingQuaternion.from_json(json["quaternion"])
                if json.get("quaternion", None) is not None
                else None
            ),
        )

quaternion: typing.Optional[SensorReadingQuaternion] = None class-attribute instance-attribute

single: typing.Optional[SensorReadingSingle] = None class-attribute instance-attribute

xyz: typing.Optional[SensorReadingXYZ] = None class-attribute instance-attribute

__init__(single=None, xyz=None, quaternion=None)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> SensorReading:
    return cls(
        single=(
            SensorReadingSingle.from_json(json["single"])
            if json.get("single", None) is not None
            else None
        ),
        xyz=(
            SensorReadingXYZ.from_json(json["xyz"])
            if json.get("xyz", None) is not None
            else None
        ),
        quaternion=(
            SensorReadingQuaternion.from_json(json["quaternion"])
            if json.get("quaternion", None) is not None
            else None
        ),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    if self.single is not None:
        json["single"] = self.single.to_json()
    if self.xyz is not None:
        json["xyz"] = self.xyz.to_json()
    if self.quaternion is not None:
        json["quaternion"] = self.quaternion.to_json()
    return json

SensorReadingQuaternion dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class SensorReadingQuaternion:
    x: float

    y: float

    z: float

    w: float

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["x"] = self.x
        json["y"] = self.y
        json["z"] = self.z
        json["w"] = self.w
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SensorReadingQuaternion:
        return cls(
            x=float(json["x"]),
            y=float(json["y"]),
            z=float(json["z"]),
            w=float(json["w"]),
        )

w: float instance-attribute

x: float instance-attribute

y: float instance-attribute

z: float instance-attribute

__init__(x, y, z, w)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> SensorReadingQuaternion:
    return cls(
        x=float(json["x"]),
        y=float(json["y"]),
        z=float(json["z"]),
        w=float(json["w"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["x"] = self.x
    json["y"] = self.y
    json["z"] = self.z
    json["w"] = self.w
    return json

SensorReadingSingle dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class SensorReadingSingle:
    value: float

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["value"] = self.value
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SensorReadingSingle:
        return cls(
            value=float(json["value"]),
        )

value: float instance-attribute

__init__(value)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> SensorReadingSingle:
    return cls(
        value=float(json["value"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["value"] = self.value
    return json

SensorReadingXYZ dataclass

Source code in zendriver/cdp/emulation.py

@dataclass
class SensorReadingXYZ:
    x: float

    y: float

    z: float

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["x"] = self.x
        json["y"] = self.y
        json["z"] = self.z
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SensorReadingXYZ:
        return cls(
            x=float(json["x"]),
            y=float(json["y"]),
            z=float(json["z"]),
        )

x: float instance-attribute

y: float instance-attribute

z: float instance-attribute

__init__(x, y, z)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> SensorReadingXYZ:
    return cls(
        x=float(json["x"]),
        y=float(json["y"]),
        z=float(json["z"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["x"] = self.x
    json["y"] = self.y
    json["z"] = self.z
    return json

SensorType

Bases: Enum

Used to specify sensor types to emulate. See https://w3c.github.io/sensors/#automation for more information.

Source code in zendriver/cdp/emulation.py

class SensorType(enum.Enum):
    """
    Used to specify sensor types to emulate.
    See https://w3c.github.io/sensors/#automation for more information.
    """

    ABSOLUTE_ORIENTATION = "absolute-orientation"
    ACCELEROMETER = "accelerometer"
    AMBIENT_LIGHT = "ambient-light"
    GRAVITY = "gravity"
    GYROSCOPE = "gyroscope"
    LINEAR_ACCELERATION = "linear-acceleration"
    MAGNETOMETER = "magnetometer"
    PROXIMITY = "proximity"
    RELATIVE_ORIENTATION = "relative-orientation"

    def to_json(self) -> str:
        return self.value

    @classmethod
    def from_json(cls, json: str) -> SensorType:
        return cls(json)

ABSOLUTE_ORIENTATION = 'absolute-orientation' class-attribute instance-attribute

ACCELEROMETER = 'accelerometer' class-attribute instance-attribute

AMBIENT_LIGHT = 'ambient-light' class-attribute instance-attribute

GRAVITY = 'gravity' class-attribute instance-attribute

GYROSCOPE = 'gyroscope' class-attribute instance-attribute

LINEAR_ACCELERATION = 'linear-acceleration' class-attribute instance-attribute

MAGNETOMETER = 'magnetometer' class-attribute instance-attribute

PROXIMITY = 'proximity' class-attribute instance-attribute

RELATIVE_ORIENTATION = 'relative-orientation' class-attribute instance-attribute

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: str) -> SensorType:
    return cls(json)

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> str:
    return self.value

UserAgentBrandVersion dataclass

Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints

Source code in zendriver/cdp/emulation.py

@dataclass
class UserAgentBrandVersion:
    """
    Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
    """

    brand: str

    version: str

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["brand"] = self.brand
        json["version"] = self.version
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> UserAgentBrandVersion:
        return cls(
            brand=str(json["brand"]),
            version=str(json["version"]),
        )

brand: str instance-attribute

version: str instance-attribute

__init__(brand, version)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> UserAgentBrandVersion:
    return cls(
        brand=str(json["brand"]),
        version=str(json["version"]),
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["brand"] = self.brand
    json["version"] = self.version
    return json

UserAgentMetadata dataclass

Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints Missing optional values will be filled in by the target with what it would normally use.

Source code in zendriver/cdp/emulation.py

@dataclass
class UserAgentMetadata:
    """
    Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
    Missing optional values will be filled in by the target with what it would normally use.
    """

    platform: str

    platform_version: str

    architecture: str

    model: str

    mobile: bool

    #: Brands appearing in Sec-CH-UA.
    brands: typing.Optional[typing.List[UserAgentBrandVersion]] = None

    #: Brands appearing in Sec-CH-UA-Full-Version-List.
    full_version_list: typing.Optional[typing.List[UserAgentBrandVersion]] = None

    full_version: typing.Optional[str] = None

    bitness: typing.Optional[str] = None

    wow64: typing.Optional[bool] = None

    def to_json(self) -> T_JSON_DICT:
        json: T_JSON_DICT = dict()
        json["platform"] = self.platform
        json["platformVersion"] = self.platform_version
        json["architecture"] = self.architecture
        json["model"] = self.model
        json["mobile"] = self.mobile
        if self.brands is not None:
            json["brands"] = [i.to_json() for i in self.brands]
        if self.full_version_list is not None:
            json["fullVersionList"] = [i.to_json() for i in self.full_version_list]
        if self.full_version is not None:
            json["fullVersion"] = self.full_version
        if self.bitness is not None:
            json["bitness"] = self.bitness
        if self.wow64 is not None:
            json["wow64"] = self.wow64
        return json

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> UserAgentMetadata:
        return cls(
            platform=str(json["platform"]),
            platform_version=str(json["platformVersion"]),
            architecture=str(json["architecture"]),
            model=str(json["model"]),
            mobile=bool(json["mobile"]),
            brands=(
                [UserAgentBrandVersion.from_json(i) for i in json["brands"]]
                if json.get("brands", None) is not None
                else None
            ),
            full_version_list=(
                [UserAgentBrandVersion.from_json(i) for i in json["fullVersionList"]]
                if json.get("fullVersionList", None) is not None
                else None
            ),
            full_version=(
                str(json["fullVersion"])
                if json.get("fullVersion", None) is not None
                else None
            ),
            bitness=(
                str(json["bitness"]) if json.get("bitness", None) is not None else None
            ),
            wow64=bool(json["wow64"]) if json.get("wow64", None) is not None else None,
        )

architecture: str instance-attribute

bitness: typing.Optional[str] = None class-attribute instance-attribute

brands: typing.Optional[typing.List[UserAgentBrandVersion]] = None class-attribute instance-attribute

full_version: typing.Optional[str] = None class-attribute instance-attribute

full_version_list: typing.Optional[typing.List[UserAgentBrandVersion]] = None class-attribute instance-attribute

mobile: bool instance-attribute

model: str instance-attribute

platform: str instance-attribute

platform_version: str instance-attribute

wow64: typing.Optional[bool] = None class-attribute instance-attribute

__init__(platform, platform_version, architecture, model, mobile, brands=None, full_version_list=None, full_version=None, bitness=None, wow64=None)

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> UserAgentMetadata:
    return cls(
        platform=str(json["platform"]),
        platform_version=str(json["platformVersion"]),
        architecture=str(json["architecture"]),
        model=str(json["model"]),
        mobile=bool(json["mobile"]),
        brands=(
            [UserAgentBrandVersion.from_json(i) for i in json["brands"]]
            if json.get("brands", None) is not None
            else None
        ),
        full_version_list=(
            [UserAgentBrandVersion.from_json(i) for i in json["fullVersionList"]]
            if json.get("fullVersionList", None) is not None
            else None
        ),
        full_version=(
            str(json["fullVersion"])
            if json.get("fullVersion", None) is not None
            else None
        ),
        bitness=(
            str(json["bitness"]) if json.get("bitness", None) is not None else None
        ),
        wow64=bool(json["wow64"]) if json.get("wow64", None) is not None else None,
    )

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> T_JSON_DICT:
    json: T_JSON_DICT = dict()
    json["platform"] = self.platform
    json["platformVersion"] = self.platform_version
    json["architecture"] = self.architecture
    json["model"] = self.model
    json["mobile"] = self.mobile
    if self.brands is not None:
        json["brands"] = [i.to_json() for i in self.brands]
    if self.full_version_list is not None:
        json["fullVersionList"] = [i.to_json() for i in self.full_version_list]
    if self.full_version is not None:
        json["fullVersion"] = self.full_version
    if self.bitness is not None:
        json["bitness"] = self.bitness
    if self.wow64 is not None:
        json["wow64"] = self.wow64
    return json

VirtualTimeBudgetExpired dataclass

EXPERIMENTAL

Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.

Source code in zendriver/cdp/emulation.py

@event_class("Emulation.virtualTimeBudgetExpired")
@dataclass
class VirtualTimeBudgetExpired:
    """
    **EXPERIMENTAL**

    Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
    """

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> VirtualTimeBudgetExpired:
        return cls()

__init__()

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: T_JSON_DICT) -> VirtualTimeBudgetExpired:
    return cls()

VirtualTimePolicy

Bases: Enum

advance: If the scheduler runs out of immediate work, the virtual time base may fast forward to allow the next delayed task (if any) to run; pause: The virtual time base may not advance; pauseIfNetworkFetchesPending: The virtual time base may not advance if there are any pending resource fetches.

Source code in zendriver/cdp/emulation.py

class VirtualTimePolicy(enum.Enum):
    """
    advance: If the scheduler runs out of immediate work, the virtual time base may fast forward to
    allow the next delayed task (if any) to run; pause: The virtual time base may not advance;
    pauseIfNetworkFetchesPending: The virtual time base may not advance if there are any pending
    resource fetches.
    """

    ADVANCE = "advance"
    PAUSE = "pause"
    PAUSE_IF_NETWORK_FETCHES_PENDING = "pauseIfNetworkFetchesPending"

    def to_json(self) -> str:
        return self.value

    @classmethod
    def from_json(cls, json: str) -> VirtualTimePolicy:
        return cls(json)

ADVANCE = 'advance' class-attribute instance-attribute

PAUSE = 'pause' class-attribute instance-attribute

PAUSE_IF_NETWORK_FETCHES_PENDING = 'pauseIfNetworkFetchesPending' class-attribute instance-attribute

from_json(json) classmethod

Source code in zendriver/cdp/emulation.py

@classmethod
def from_json(cls, json: str) -> VirtualTimePolicy:
    return cls(json)

to_json()

Source code in zendriver/cdp/emulation.py

def to_json(self) -> str:
    return self.value

can_emulate()

Tells whether emulation is supported.

.. deprecated:: 1.3

Returns:

Type	Description
Generator[T_JSON_DICT, T_JSON_DICT, bool]	True if emulation is supported.

Source code in zendriver/cdp/emulation.py

@deprecated(version="1.3")
def can_emulate() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, bool]:
    """
    Tells whether emulation is supported.

    .. deprecated:: 1.3

    :returns: True if emulation is supported.
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.canEmulate",
    }
    json = yield cmd_dict
    return bool(json["result"])

clear_device_metrics_override()

Clears the overridden device metrics.

Source code in zendriver/cdp/emulation.py

def clear_device_metrics_override() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Clears the overridden device metrics.
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.clearDeviceMetricsOverride",
    }
    json = yield cmd_dict

clear_device_posture_override()

Clears a device posture override set with either setDeviceMetricsOverride() or setDevicePostureOverride() and starts using posture information from the platform again. Does nothing if no override is set.

EXPERIMENTAL

Source code in zendriver/cdp/emulation.py

def clear_device_posture_override() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Clears a device posture override set with either setDeviceMetricsOverride()
    or setDevicePostureOverride() and starts using posture information from the
    platform again.
    Does nothing if no override is set.

    **EXPERIMENTAL**
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.clearDevicePostureOverride",
    }
    json = yield cmd_dict

clear_geolocation_override()

Clears the overridden Geolocation Position and Error.

Source code in zendriver/cdp/emulation.py

def clear_geolocation_override() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Clears the overridden Geolocation Position and Error.
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.clearGeolocationOverride",
    }
    json = yield cmd_dict

clear_idle_override()

Clears Idle state overrides.

Source code in zendriver/cdp/emulation.py

def clear_idle_override() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Clears Idle state overrides.
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.clearIdleOverride",
    }
    json = yield cmd_dict

get_overridden_sensor_information(type_)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
type_	SensorType		required

Returns:

Type	Description
Generator[T_JSON_DICT, T_JSON_DICT, float]

Source code in zendriver/cdp/emulation.py

def get_overridden_sensor_information(
    type_: SensorType,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, float]:
    """


    **EXPERIMENTAL**

    :param type_:
    :returns:
    """
    params: T_JSON_DICT = dict()
    params["type"] = type_.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.getOverriddenSensorInformation",
        "params": params,
    }
    json = yield cmd_dict
    return float(json["requestedSamplingFrequency"])

reset_page_scale_factor()

Requests that page scale factor is reset to initial values.

EXPERIMENTAL

Source code in zendriver/cdp/emulation.py

def reset_page_scale_factor() -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Requests that page scale factor is reset to initial values.

    **EXPERIMENTAL**
    """
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.resetPageScaleFactor",
    }
    json = yield cmd_dict

set_auto_dark_mode_override(enabled=None)

Automatically render all web contents using a dark theme.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
enabled	Optional[bool]	(Optional) Whether to enable or disable automatic dark mode. If not specified, any existing override will be cleared.	None

Source code in zendriver/cdp/emulation.py

def set_auto_dark_mode_override(
    enabled: typing.Optional[bool] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Automatically render all web contents using a dark theme.

    **EXPERIMENTAL**

    :param enabled: *(Optional)* Whether to enable or disable automatic dark mode. If not specified, any existing override will be cleared.
    """
    params: T_JSON_DICT = dict()
    if enabled is not None:
        params["enabled"] = enabled
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setAutoDarkModeOverride",
        "params": params,
    }
    json = yield cmd_dict

set_automation_override(enabled)

Allows overriding the automation flag.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
enabled	bool	Whether the override should be enabled.	required

Source code in zendriver/cdp/emulation.py

def set_automation_override(
    enabled: bool,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Allows overriding the automation flag.

    **EXPERIMENTAL**

    :param enabled: Whether the override should be enabled.
    """
    params: T_JSON_DICT = dict()
    params["enabled"] = enabled
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setAutomationOverride",
        "params": params,
    }
    json = yield cmd_dict

set_cpu_throttling_rate(rate)

Enables CPU throttling to emulate slow CPUs.

Parameters:

Name	Type	Description	Default
rate	float	Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).	required

Source code in zendriver/cdp/emulation.py

def set_cpu_throttling_rate(
    rate: float,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Enables CPU throttling to emulate slow CPUs.

    :param rate: Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
    """
    params: T_JSON_DICT = dict()
    params["rate"] = rate
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setCPUThrottlingRate",
        "params": params,
    }
    json = yield cmd_dict

set_default_background_color_override(color=None)

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:

Name	Type	Description	Default
color	Optional[RGBA]	(Optional) RGBA of the default background color. If not specified, any existing override will be cleared.	None

Source code in zendriver/cdp/emulation.py

def set_default_background_color_override(
    color: typing.Optional[dom.RGBA] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Sets or clears an override of the default background color of the frame. This override is used
    if the content does not specify one.

    :param color: *(Optional)* RGBA of the default background color. If not specified, any existing override will be cleared.
    """
    params: T_JSON_DICT = dict()
    if color is not None:
        params["color"] = color.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setDefaultBackgroundColorOverride",
        "params": params,
    }
    json = yield cmd_dict

set_device_metrics_override(width, height, device_scale_factor, mobile, scale=None, screen_width=None, screen_height=None, position_x=None, position_y=None, dont_set_visible_size=None, screen_orientation=None, viewport=None, display_feature=None, device_posture=None)

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:

Name	Type	Description	Default
width	int	Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.	required
height	int	Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.	required
device_scale_factor	float	Overriding device scale factor value. 0 disables the override.	required
mobile	bool	Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.	required
scale	Optional[float]	(EXPERIMENTAL) (Optional) Scale to apply to resulting view image.	None
screen_width	Optional[int]	(EXPERIMENTAL) (Optional) Overriding screen width value in pixels (minimum 0, maximum 10000000).	None
screen_height	Optional[int]	(EXPERIMENTAL) (Optional) Overriding screen height value in pixels (minimum 0, maximum 10000000).	None
position_x	Optional[int]	(EXPERIMENTAL) (Optional) Overriding view X position on screen in pixels (minimum 0, maximum 10000000).	None
position_y	Optional[int]	(EXPERIMENTAL) (Optional) Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).	None
dont_set_visible_size	Optional[bool]	(EXPERIMENTAL) (Optional) Do not set visible view size, rely upon explicit setVisibleSize call.	None
screen_orientation	Optional[ScreenOrientation]	(Optional) Screen orientation override.	None
viewport	Optional[Viewport]	(EXPERIMENTAL) (Optional) If set, the visible area of the page will be overridden to this viewport. This viewport change is not observed by the page, e.g. viewport-relative elements do not change positions.	None
display_feature	Optional[DisplayFeature]	(EXPERIMENTAL) (Optional) If set, the display feature of a multi-segment screen. If not set, multi-segment support is turned-off.	None
device_posture	Optional[DevicePosture]	(DEPRECATED) (EXPERIMENTAL) (Optional) If set, the posture of a foldable device. If not set the posture is set to continuous. Deprecated, use Emulation.setDevicePostureOverride.	None

Source code in zendriver/cdp/emulation.py

def set_device_metrics_override(
    width: int,
    height: int,
    device_scale_factor: float,
    mobile: bool,
    scale: typing.Optional[float] = None,
    screen_width: typing.Optional[int] = None,
    screen_height: typing.Optional[int] = None,
    position_x: typing.Optional[int] = None,
    position_y: typing.Optional[int] = None,
    dont_set_visible_size: typing.Optional[bool] = None,
    screen_orientation: typing.Optional[ScreenOrientation] = None,
    viewport: typing.Optional[page.Viewport] = None,
    display_feature: typing.Optional[DisplayFeature] = None,
    device_posture: typing.Optional[DevicePosture] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    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).

    :param width: Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
    :param height: Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
    :param device_scale_factor: Overriding device scale factor value. 0 disables the override.
    :param mobile: Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.
    :param scale: **(EXPERIMENTAL)** *(Optional)* Scale to apply to resulting view image.
    :param screen_width: **(EXPERIMENTAL)** *(Optional)* Overriding screen width value in pixels (minimum 0, maximum 10000000).
    :param screen_height: **(EXPERIMENTAL)** *(Optional)* Overriding screen height value in pixels (minimum 0, maximum 10000000).
    :param position_x: **(EXPERIMENTAL)** *(Optional)* Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
    :param position_y: **(EXPERIMENTAL)** *(Optional)* Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
    :param dont_set_visible_size: **(EXPERIMENTAL)** *(Optional)* Do not set visible view size, rely upon explicit setVisibleSize call.
    :param screen_orientation: *(Optional)* Screen orientation override.
    :param viewport: **(EXPERIMENTAL)** *(Optional)* If set, the visible area of the page will be overridden to this viewport. This viewport change is not observed by the page, e.g. viewport-relative elements do not change positions.
    :param display_feature: **(EXPERIMENTAL)** *(Optional)* If set, the display feature of a multi-segment screen. If not set, multi-segment support is turned-off.
    :param device_posture: **(DEPRECATED)** **(EXPERIMENTAL)** *(Optional)* If set, the posture of a foldable device. If not set the posture is set to continuous. Deprecated, use Emulation.setDevicePostureOverride.
    """
    params: T_JSON_DICT = dict()
    params["width"] = width
    params["height"] = height
    params["deviceScaleFactor"] = device_scale_factor
    params["mobile"] = mobile
    if scale is not None:
        params["scale"] = scale
    if screen_width is not None:
        params["screenWidth"] = screen_width
    if screen_height is not None:
        params["screenHeight"] = screen_height
    if position_x is not None:
        params["positionX"] = position_x
    if position_y is not None:
        params["positionY"] = position_y
    if dont_set_visible_size is not None:
        params["dontSetVisibleSize"] = dont_set_visible_size
    if screen_orientation is not None:
        params["screenOrientation"] = screen_orientation.to_json()
    if viewport is not None:
        params["viewport"] = viewport.to_json()
    if display_feature is not None:
        params["displayFeature"] = display_feature.to_json()
    if device_posture is not None:
        params["devicePosture"] = device_posture.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setDeviceMetricsOverride",
        "params": params,
    }
    json = yield cmd_dict

set_device_posture_override(posture)

Start reporting the given posture value to the Device Posture API. This override can also be set in setDeviceMetricsOverride().

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
posture	DevicePosture		required

Source code in zendriver/cdp/emulation.py

def set_device_posture_override(
    posture: DevicePosture,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Start reporting the given posture value to the Device Posture API.
    This override can also be set in setDeviceMetricsOverride().

    **EXPERIMENTAL**

    :param posture:
    """
    params: T_JSON_DICT = dict()
    params["posture"] = posture.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setDevicePostureOverride",
        "params": params,
    }
    json = yield cmd_dict

set_disabled_image_types(image_types)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
image_types	List[DisabledImageType]	Image types to disable.	required

Source code in zendriver/cdp/emulation.py

def set_disabled_image_types(
    image_types: typing.List[DisabledImageType],
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """


    **EXPERIMENTAL**

    :param image_types: Image types to disable.
    """
    params: T_JSON_DICT = dict()
    params["imageTypes"] = [i.to_json() for i in image_types]
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setDisabledImageTypes",
        "params": params,
    }
    json = yield cmd_dict

set_document_cookie_disabled(disabled)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
disabled	bool	Whether document.coookie API should be disabled.	required

Source code in zendriver/cdp/emulation.py

def set_document_cookie_disabled(
    disabled: bool,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """


    **EXPERIMENTAL**

    :param disabled: Whether document.coookie API should be disabled.
    """
    params: T_JSON_DICT = dict()
    params["disabled"] = disabled
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setDocumentCookieDisabled",
        "params": params,
    }
    json = yield cmd_dict

set_emit_touch_events_for_mouse(enabled, configuration=None)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
enabled	bool	Whether touch emulation based on mouse input should be enabled.	required
configuration	Optional[str]	(Optional) Touch/gesture events configuration. Default: current platform.	None

Source code in zendriver/cdp/emulation.py

def set_emit_touch_events_for_mouse(
    enabled: bool, configuration: typing.Optional[str] = None
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """


    **EXPERIMENTAL**

    :param enabled: Whether touch emulation based on mouse input should be enabled.
    :param configuration: *(Optional)* Touch/gesture events configuration. Default: current platform.
    """
    params: T_JSON_DICT = dict()
    params["enabled"] = enabled
    if configuration is not None:
        params["configuration"] = configuration
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setEmitTouchEventsForMouse",
        "params": params,
    }
    json = yield cmd_dict

set_emulated_media(media=None, features=None)

Emulates the given media type or media feature for CSS media queries.

Parameters:

Name	Type	Description	Default
media	Optional[str]	(Optional) Media type to emulate. Empty string disables the override.	None
features	Optional[List[MediaFeature]]	(Optional) Media features to emulate.	None

Source code in zendriver/cdp/emulation.py

def set_emulated_media(
    media: typing.Optional[str] = None,
    features: typing.Optional[typing.List[MediaFeature]] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Emulates the given media type or media feature for CSS media queries.

    :param media: *(Optional)* Media type to emulate. Empty string disables the override.
    :param features: *(Optional)* Media features to emulate.
    """
    params: T_JSON_DICT = dict()
    if media is not None:
        params["media"] = media
    if features is not None:
        params["features"] = [i.to_json() for i in features]
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setEmulatedMedia",
        "params": params,
    }
    json = yield cmd_dict

set_emulated_vision_deficiency(type_)

Emulates the given vision deficiency.

Parameters:

Name	Type	Description	Default
type_	str	Vision deficiency to emulate. Order: best-effort emulations come first, followed by any physiologically accurate emulations for medically recognized color vision deficiencies.	required

Source code in zendriver/cdp/emulation.py

def set_emulated_vision_deficiency(
    type_: str,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Emulates the given vision deficiency.

    :param type_: Vision deficiency to emulate. Order: best-effort emulations come first, followed by any physiologically accurate emulations for medically recognized color vision deficiencies.
    """
    params: T_JSON_DICT = dict()
    params["type"] = type_
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setEmulatedVisionDeficiency",
        "params": params,
    }
    json = yield cmd_dict

set_focus_emulation_enabled(enabled)

Enables or disables simulating a focused and active page.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
enabled	bool	Whether to enable to disable focus emulation.	required

Source code in zendriver/cdp/emulation.py

def set_focus_emulation_enabled(
    enabled: bool,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Enables or disables simulating a focused and active page.

    **EXPERIMENTAL**

    :param enabled: Whether to enable to disable focus emulation.
    """
    params: T_JSON_DICT = dict()
    params["enabled"] = enabled
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setFocusEmulationEnabled",
        "params": params,
    }
    json = yield cmd_dict

set_geolocation_override(latitude=None, longitude=None, accuracy=None)

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

Parameters:

Name	Type	Description	Default
latitude	Optional[float]	(Optional) Mock latitude	None
longitude	Optional[float]	(Optional) Mock longitude	None
accuracy	Optional[float]	(Optional) Mock accuracy	None

Source code in zendriver/cdp/emulation.py

def set_geolocation_override(
    latitude: typing.Optional[float] = None,
    longitude: typing.Optional[float] = None,
    accuracy: typing.Optional[float] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
    unavailable.

    :param latitude: *(Optional)* Mock latitude
    :param longitude: *(Optional)* Mock longitude
    :param accuracy: *(Optional)* Mock accuracy
    """
    params: T_JSON_DICT = dict()
    if latitude is not None:
        params["latitude"] = latitude
    if longitude is not None:
        params["longitude"] = longitude
    if accuracy is not None:
        params["accuracy"] = accuracy
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setGeolocationOverride",
        "params": params,
    }
    json = yield cmd_dict

set_hardware_concurrency_override(hardware_concurrency)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
hardware_concurrency	int	Hardware concurrency to report	required

Source code in zendriver/cdp/emulation.py

def set_hardware_concurrency_override(
    hardware_concurrency: int,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """


    **EXPERIMENTAL**

    :param hardware_concurrency: Hardware concurrency to report
    """
    params: T_JSON_DICT = dict()
    params["hardwareConcurrency"] = hardware_concurrency
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setHardwareConcurrencyOverride",
        "params": params,
    }
    json = yield cmd_dict

set_idle_override(is_user_active, is_screen_unlocked)

Overrides the Idle state.

Parameters:

Name	Type	Description	Default
is_user_active	bool	Mock isUserActive	required
is_screen_unlocked	bool	Mock isScreenUnlocked	required

Source code in zendriver/cdp/emulation.py

def set_idle_override(
    is_user_active: bool, is_screen_unlocked: bool
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides the Idle state.

    :param is_user_active: Mock isUserActive
    :param is_screen_unlocked: Mock isScreenUnlocked
    """
    params: T_JSON_DICT = dict()
    params["isUserActive"] = is_user_active
    params["isScreenUnlocked"] = is_screen_unlocked
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setIdleOverride",
        "params": params,
    }
    json = yield cmd_dict

set_locale_override(locale=None)

Overrides default host system locale with the specified one.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
locale	Optional[str]	(Optional) ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and restores default host system locale.	None

Source code in zendriver/cdp/emulation.py

def set_locale_override(
    locale: typing.Optional[str] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides default host system locale with the specified one.

    **EXPERIMENTAL**

    :param locale: *(Optional)* ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and restores default host system locale.
    """
    params: T_JSON_DICT = dict()
    if locale is not None:
        params["locale"] = locale
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setLocaleOverride",
        "params": params,
    }
    json = yield cmd_dict

set_navigator_overrides(platform)

Overrides value returned by the javascript navigator object.

.. deprecated:: 1.3

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
platform	str	The platform navigator.platform should return.	required

Source code in zendriver/cdp/emulation.py

@deprecated(version="1.3")
def set_navigator_overrides(
    platform: str,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides value returned by the javascript navigator object.

    .. deprecated:: 1.3

    **EXPERIMENTAL**

    :param platform: The platform navigator.platform should return.
    """
    params: T_JSON_DICT = dict()
    params["platform"] = platform
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setNavigatorOverrides",
        "params": params,
    }
    json = yield cmd_dict

set_page_scale_factor(page_scale_factor)

Sets a specified page scale factor.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
page_scale_factor	float	Page scale factor.	required

Source code in zendriver/cdp/emulation.py

def set_page_scale_factor(
    page_scale_factor: float,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Sets a specified page scale factor.

    **EXPERIMENTAL**

    :param page_scale_factor: Page scale factor.
    """
    params: T_JSON_DICT = dict()
    params["pageScaleFactor"] = page_scale_factor
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setPageScaleFactor",
        "params": params,
    }
    json = yield cmd_dict

set_script_execution_disabled(value)

Switches script execution in the page.

Parameters:

Name	Type	Description	Default
value	bool	Whether script execution should be disabled in the page.	required

Source code in zendriver/cdp/emulation.py

def set_script_execution_disabled(
    value: bool,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Switches script execution in the page.

    :param value: Whether script execution should be disabled in the page.
    """
    params: T_JSON_DICT = dict()
    params["value"] = value
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setScriptExecutionDisabled",
        "params": params,
    }
    json = yield cmd_dict

set_scrollbars_hidden(hidden)

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
hidden	bool	Whether scrollbars should be always hidden.	required

Source code in zendriver/cdp/emulation.py

def set_scrollbars_hidden(
    hidden: bool,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """


    **EXPERIMENTAL**

    :param hidden: Whether scrollbars should be always hidden.
    """
    params: T_JSON_DICT = dict()
    params["hidden"] = hidden
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setScrollbarsHidden",
        "params": params,
    }
    json = yield cmd_dict

set_sensor_override_enabled(enabled, type_, metadata=None)

Overrides a platform sensor of a given type. If enabled is true, calls to Sensor.start() will use a virtual sensor as backend rather than fetching data from a real hardware sensor. Otherwise, existing virtual sensor-backend Sensor objects will fire an error event and new calls to Sensor.start() will attempt to use a real sensor instead.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
enabled	bool		required
type_	SensorType		required
metadata	Optional[SensorMetadata]	(Optional)	None

Source code in zendriver/cdp/emulation.py

def set_sensor_override_enabled(
    enabled: bool, type_: SensorType, metadata: typing.Optional[SensorMetadata] = None
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides a platform sensor of a given type. If ``enabled`` is true, calls to
    Sensor.start() will use a virtual sensor as backend rather than fetching
    data from a real hardware sensor. Otherwise, existing virtual
    sensor-backend Sensor objects will fire an error event and new calls to
    Sensor.start() will attempt to use a real sensor instead.

    **EXPERIMENTAL**

    :param enabled:
    :param type_:
    :param metadata: *(Optional)*
    """
    params: T_JSON_DICT = dict()
    params["enabled"] = enabled
    params["type"] = type_.to_json()
    if metadata is not None:
        params["metadata"] = metadata.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setSensorOverrideEnabled",
        "params": params,
    }
    json = yield cmd_dict

set_sensor_override_readings(type_, reading)

Updates the sensor readings reported by a sensor type previously overridden by setSensorOverrideEnabled.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
type_	SensorType		required
reading	SensorReading		required

Source code in zendriver/cdp/emulation.py

def set_sensor_override_readings(
    type_: SensorType, reading: SensorReading
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Updates the sensor readings reported by a sensor type previously overridden
    by setSensorOverrideEnabled.

    **EXPERIMENTAL**

    :param type_:
    :param reading:
    """
    params: T_JSON_DICT = dict()
    params["type"] = type_.to_json()
    params["reading"] = reading.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setSensorOverrideReadings",
        "params": params,
    }
    json = yield cmd_dict

set_timezone_override(timezone_id)

Overrides default host system timezone with the specified one.

Parameters:

Name	Type	Description	Default
timezone_id	str	The timezone identifier. List of supported timezones: https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt If empty, disables the override and restores default host system timezone.	required

Source code in zendriver/cdp/emulation.py

def set_timezone_override(
    timezone_id: str,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Overrides default host system timezone with the specified one.

    :param timezone_id: The timezone identifier. List of supported timezones: https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt If empty, disables the override and restores default host system timezone.
    """
    params: T_JSON_DICT = dict()
    params["timezoneId"] = timezone_id
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setTimezoneOverride",
        "params": params,
    }
    json = yield cmd_dict

set_touch_emulation_enabled(enabled, max_touch_points=None)

Enables touch on platforms which do not support them.

Parameters:

Name	Type	Description	Default
enabled	bool	Whether the touch event emulation should be enabled.	required
max_touch_points	Optional[int]	(Optional) Maximum touch points supported. Defaults to one.	None

Source code in zendriver/cdp/emulation.py

def set_touch_emulation_enabled(
    enabled: bool, max_touch_points: typing.Optional[int] = None
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Enables touch on platforms which do not support them.

    :param enabled: Whether the touch event emulation should be enabled.
    :param max_touch_points: *(Optional)* Maximum touch points supported. Defaults to one.
    """
    params: T_JSON_DICT = dict()
    params["enabled"] = enabled
    if max_touch_points is not None:
        params["maxTouchPoints"] = max_touch_points
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setTouchEmulationEnabled",
        "params": params,
    }
    json = yield cmd_dict

set_user_agent_override(user_agent, accept_language=None, platform=None, user_agent_metadata=None)

Allows overriding user agent with the given string. userAgentMetadata must be set for Client Hint headers to be sent.

Parameters:

Name	Type	Description	Default
user_agent	str	User agent to use.	required
accept_language	Optional[str]	(Optional) Browser language to emulate.	None
platform	Optional[str]	(Optional) The platform navigator.platform should return.	None
user_agent_metadata	Optional[UserAgentMetadata]	(EXPERIMENTAL) (Optional) To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData	None

Source code in zendriver/cdp/emulation.py

def set_user_agent_override(
    user_agent: str,
    accept_language: typing.Optional[str] = None,
    platform: typing.Optional[str] = None,
    user_agent_metadata: typing.Optional[UserAgentMetadata] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    Allows overriding user agent with the given string.
    ``userAgentMetadata`` must be set for Client Hint headers to be sent.

    :param user_agent: User agent to use.
    :param accept_language: *(Optional)* Browser language to emulate.
    :param platform: *(Optional)* The platform navigator.platform should return.
    :param user_agent_metadata: **(EXPERIMENTAL)** *(Optional)* To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
    """
    params: T_JSON_DICT = dict()
    params["userAgent"] = user_agent
    if accept_language is not None:
        params["acceptLanguage"] = accept_language
    if platform is not None:
        params["platform"] = platform
    if user_agent_metadata is not None:
        params["userAgentMetadata"] = user_agent_metadata.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setUserAgentOverride",
        "params": params,
    }
    json = yield cmd_dict

set_virtual_time_policy(policy, budget=None, max_virtual_time_task_starvation_count=None, initial_virtual_time=None)

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.

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
policy	VirtualTimePolicy		required
budget	Optional[float]	(Optional) If set, after this many virtual milliseconds have elapsed virtual time will be paused and a virtualTimeBudgetExpired event is sent.	None
max_virtual_time_task_starvation_count	Optional[int]	(Optional) If set this specifies the maximum number of tasks that can be run before virtual is forced forwards to prevent deadlock.	None
initial_virtual_time	Optional[TimeSinceEpoch]	(Optional) If set, base::Time::Now will be overridden to initially return this value.	None

Returns:

Type	Description
Generator[T_JSON_DICT, T_JSON_DICT, float]	Absolute timestamp at which virtual time was first enabled (up time in milliseconds).

Source code in zendriver/cdp/emulation.py

def set_virtual_time_policy(
    policy: VirtualTimePolicy,
    budget: typing.Optional[float] = None,
    max_virtual_time_task_starvation_count: typing.Optional[int] = None,
    initial_virtual_time: typing.Optional[network.TimeSinceEpoch] = None,
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, float]:
    """
    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.

    **EXPERIMENTAL**

    :param policy:
    :param budget: *(Optional)* If set, after this many virtual milliseconds have elapsed virtual time will be paused and a virtualTimeBudgetExpired event is sent.
    :param max_virtual_time_task_starvation_count: *(Optional)* If set this specifies the maximum number of tasks that can be run before virtual is forced forwards to prevent deadlock.
    :param initial_virtual_time: *(Optional)* If set, base::Time::Now will be overridden to initially return this value.
    :returns: Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
    """
    params: T_JSON_DICT = dict()
    params["policy"] = policy.to_json()
    if budget is not None:
        params["budget"] = budget
    if max_virtual_time_task_starvation_count is not None:
        params["maxVirtualTimeTaskStarvationCount"] = (
            max_virtual_time_task_starvation_count
        )
    if initial_virtual_time is not None:
        params["initialVirtualTime"] = initial_virtual_time.to_json()
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setVirtualTimePolicy",
        "params": params,
    }
    json = yield cmd_dict
    return float(json["virtualTimeTicksBase"])

set_visible_size(width, 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.

.. deprecated:: 1.3

EXPERIMENTAL

Parameters:

Name	Type	Description	Default
width	int	Frame width (DIP).	required
height	int	Frame height (DIP).	required

Source code in zendriver/cdp/emulation.py

@deprecated(version="1.3")
def set_visible_size(
    width: int, height: int
) -> typing.Generator[T_JSON_DICT, T_JSON_DICT, None]:
    """
    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.

    .. deprecated:: 1.3

    **EXPERIMENTAL**

    :param width: Frame width (DIP).
    :param height: Frame height (DIP).
    """
    params: T_JSON_DICT = dict()
    params["width"] = width
    params["height"] = height
    cmd_dict: T_JSON_DICT = {
        "method": "Emulation.setVisibleSize",
        "params": params,
    }
    json = yield cmd_dict