SystemInfo

The SystemInfo domain defines methods and events for querying low-level system information.

This CDP domain is experimental.

• Types

• Commands

• Events

Types

Generally, you do not need to instantiate CDP types yourself. Instead, the API creates objects for you as return values from commands, and then you can use those objects as arguments to other commands.

class GPUDevice(vendor_id, device_id, vendor_string, device_string, driver_vendor, driver_version, sub_sys_id=None, revision=None)

Describes a single graphics processor (GPU).

vendor_id: float

PCI ID of the GPU vendor, if available; 0 otherwise.

device_id: float

PCI ID of the GPU device, if available; 0 otherwise.

vendor_string: str

String description of the GPU vendor, if the PCI ID is not available.

device_string: str

String description of the GPU device, if the PCI ID is not available.

driver_vendor: str

String description of the GPU driver vendor.

driver_version: str

String description of the GPU driver version.

sub_sys_id: float | None = None

Sub sys ID of the GPU, only available on Windows.

revision: float | None = None

Revision of the GPU, only available on Windows.

class Size(width, height)

Describes the width and height dimensions of an entity.

width: int

Width in pixels.

height: int

Height in pixels.

class VideoDecodeAcceleratorCapability(profile, max_resolution, min_resolution)

Describes a supported video decoding profile with its associated minimum and maximum resolutions.

profile: str

Video codec profile that is supported, e.g. VP9 Profile 2.

max_resolution: Size

Maximum video dimensions in pixels supported for this profile.

min_resolution: Size

Minimum video dimensions in pixels supported for this profile.

class VideoEncodeAcceleratorCapability(profile, max_resolution, max_framerate_numerator, max_framerate_denominator)

Describes a supported video encoding profile with its associated maximum resolution and maximum framerate.

profile: str

Video codec profile that is supported, e.g H264 Main.

max_resolution: Size

Maximum video dimensions in pixels supported for this profile.

max_framerate_numerator: int

Maximum encoding framerate in frames per second supported for this profile, as fraction’s numerator and denominator, e.g. 24/1 fps, 24000/1001 fps, etc.

max_framerate_denominator: int

class SubsamplingFormat(*values)

YUV subsampling type of the pixels of a given image.

YUV420 = 'yuv420'

YUV422 = 'yuv422'

YUV444 = 'yuv444'

class ImageType(*values)

Image format of a given image.

JPEG = 'jpeg'

WEBP = 'webp'

UNKNOWN = 'unknown'

class GPUInfo(devices, driver_bug_workarounds, video_decoding, video_encoding, aux_attributes=None, feature_status=None)

Provides information about the GPU(s) on the system.

devices: List[GPUDevice]

The graphics devices on the system. Element 0 is the primary GPU.

driver_bug_workarounds: List[str]

An optional array of GPU driver bug workarounds.

video_decoding: List[VideoDecodeAcceleratorCapability]

Supported accelerated video decoding capabilities.

video_encoding: List[VideoEncodeAcceleratorCapability]

Supported accelerated video encoding capabilities.

aux_attributes: dict | None = None

An optional dictionary of additional GPU related attributes.

feature_status: dict | None = None

An optional dictionary of graphics features and their status.

class ProcessInfo(type_, id_, cpu_time)

Represents process info.

type_: str

Specifies process type.

id_: int

Specifies process id.

cpu_time: float

Specifies cumulative CPU usage in seconds across all threads of the process since the process start.

Commands

Each command is a generator function. The return type Generator[x, y, z] indicates that the generator yields arguments of type x, it must be resumed with an argument of type y, and it returns type z. In this library, types x and y are the same for all commands, and z is the return type you should pay attention to. For more information, see Getting Started: Commands.

get_feature_state(feature_state)

Returns information about the feature state.

Parameters:

feature_state (str)

Return type:

Generator[Dict[str, Any], Dict[str, Any], bool]

Returns:

get_info()

Returns information about the system.

Return type:

Generator[Dict[str, Any], Dict[str, Any], Tuple[GPUInfo, str, str, str]]

Returns:

A tuple with the following items:

0. gpu - Information about the GPUs on the system.

1. modelName - A platform-dependent description of the model of the machine. On Mac OS, this is, for example, ‘MacBookPro’. Will be the empty string if not supported.

2. modelVersion - A platform-dependent description of the version of the machine. On Mac OS, this is, for example, ‘10.1’. Will be the empty string if not supported.

3. commandLine - The command line string used to launch the browser. Will be the empty string if not supported.

get_process_info()

Returns information about all running processes.

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[ProcessInfo]]

Returns:

An array of process info blocks.

Events

There are no events in this module.