`Emulation.addScreen`

Add a new screen to the device. Only supported in headless mode.

Domain: Emulation experimental

Parameters

Name	Type	Description
`left`	`integer`	Offset of the left edge of the screen in pixels.
`top`	`integer`	Offset of the top edge of the screen in pixels.
`width`	`integer`	The width of the screen in pixels.
`height`	`integer`	The height of the screen in pixels.
`workAreaInsets` (optional)	`WorkAreaInsets`	Specifies the screen's work area. Default is entire screen.
`devicePixelRatio` (optional)	`number`	Specifies the screen's device pixel ratio. Default is 1.
`rotation` (optional)	`integer`	Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270. Default is 0.
`colorDepth` (optional)	`integer`	Specifies the screen's color depth in bits. Default is 24.
`label` (optional)	`string`	Specifies the descriptive label for the screen. Default is none.
`isInternal` (optional)	`boolean`	Indicates whether the screen is internal to the device or external, attached to the device. Default is false.

Returns

Name	Type	Description
`screenInfo`	`ScreenInfo`

Example Request

{
  "id": 1,
  "method": "Emulation.addScreen",
  "params": {
    "left": 1,
    "top": 1,
    "width": 1280,
    "height": 720
  }
}

Example Response

{
  "id": 1,
  "result": {
    "screenInfo": "screenInfo-value"
  }
}

Usage in Node.js

const result = await send('Emulation.addScreen', {"left": 1, "top": 1, "width": 1280, "height": 720});
console.log(result);
// {"screenInfo": "screenInfo-value"}