Class CreateTargetCommandSettings

Namespace

OpenQA.Selenium.DevTools.V152.Target

Assembly

Selenium.WebDriver.dll

Creates a new page.

public sealed class CreateTargetCommandSettings : ICommand

Inheritance

object

CreateTargetCommandSettings

Implements

ICommand

Inherited Members

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

Properties

Background

Whether to create the target in background or foreground (false by default, not supported by headless shell).

[JsonPropertyName("background")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? Background { get; set; }

Property Value

bool?

BrowserContextId

The browser context to create the page in.

[JsonPropertyName("browserContextId")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public string? BrowserContextId { get; set; }

Property Value

string

CommandName

Gets the name of the command.

[JsonIgnore]
public string CommandName { get; }

Property Value

string

EnableBeginFrameControl

Whether BeginFrames for this target will be controlled via DevTools (headless shell only, not supported on MacOS yet, false by default).

[JsonPropertyName("enableBeginFrameControl")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? EnableBeginFrameControl { get; set; }

Property Value

bool?

Focus

If specified, determines whether the new target should be focused. By default, the focus behavior depends on the background parameter:

• If background is false (default) and focus is omitted, the new target is focused and the browser window is brought to the foreground.
• If background is false and focus is false, the target is opened but the browser window's focus remains unchanged (e.g., if the window was in the background, it stays there).
• If background is true, setting focus to true is not supported and will result in an error.

[JsonPropertyName("focus")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? Focus { get; set; }

Property Value

bool?

ForTab

Whether to create the target of type "tab".

[JsonPropertyName("forTab")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? ForTab { get; set; }

Property Value

bool?

Height

Frame height in DIP (requires newWindow to be true or headless shell).

[JsonPropertyName("height")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public long? Height { get; set; }

Property Value

long?

Hidden

Whether to create a hidden target. The hidden target is observable via protocol, but not present in the tab UI strip. Cannot be created with forTab: true, newWindow: true or background: false. The life-time of the tab is limited to the life-time of the session.

[JsonPropertyName("hidden")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? Hidden { get; set; }

Property Value

bool?

Left

Frame left origin in DIP (requires newWindow to be true or headless shell).

[JsonPropertyName("left")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public long? Left { get; set; }

Property Value

long?

NewWindow

Whether to create a new Window or Tab (false by default, not supported by headless shell).

[JsonPropertyName("newWindow")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public bool? NewWindow { get; set; }

Property Value

bool?

Top

Frame top origin in DIP (requires newWindow to be true or headless shell).

[JsonPropertyName("top")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public long? Top { get; set; }

Property Value

long?

Url

The initial URL the page will be navigated to. An empty string indicates about:blank.

[JsonPropertyName("url")]
public string Url { get; set; }

Property Value

string

Width

Frame width in DIP (requires newWindow to be true or headless shell).

[JsonPropertyName("width")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public long? Width { get; set; }

Property Value

long?

WindowState

Frame window state (requires newWindow to be true or headless shell). Default is normal.

[JsonPropertyName("windowState")]
[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
public WindowState? WindowState { get; set; }

Property Value

WindowState?