A base class representing a driver for a web browser.
public class WebDriver : IWebDriver, IDisposable, ISearchContext, IJavaScriptExecutor, IFindsElement, ITakesScreenshot, ISupportsPrint, IActionExecutor, IAllowsFileDetection, IHasCapabilities, IHasCommandExecutor, IHasSessionId, ICustomDriverCommandExecutor, IHasVirtualAuthenticatorWebDriver
Initializes a new instance of the WebDriver class.
protected WebDriver(ICommandExecutor executor, ICapabilities capabilities)executor ICommandExecutor
The ICommandExecutor object used to execute commands.
capabilities ICapabilities
The ICapabilities object used to configure the driver session.
The default command timeout for HTTP requests in a RemoteWebDriver instance.
protected static readonly TimeSpan DefaultCommandTimeoutGets the cached virtual authenticator ID, or null if no authenticator ID is set.
public string? AuthenticatorId { get; }Gets the ICapabilities that the driver session was created with, which may be different from those requested.
public ICapabilities Capabilities { get; }Gets the ICommandExecutor which executes commands for this driver.
public ICommandExecutor CommandExecutor { get; }Gets the current window handle, which is an opaque handle to this window that uniquely identifies it within this driver instance.
public string CurrentWindowHandle { get; }Gets or sets the factory object used to create instances of WebElement or its subclasses.
protected WebElementFactory ElementFactory { get; set; }If value is set to null.
Gets or sets the IFileDetector responsible for detecting sequences of keystrokes representing file paths and names.
public virtual IFileDetector FileDetector { get; set; }If value is set to null.
Gets a value indicating whether this object is a valid action executor.
public bool IsActionExecutor { get; }Gets the source of the page last loaded by the browser.
public string PageSource { get; }Gets the SessionId for the current session of this driver.
public SessionId SessionId { get; }Gets the title of the current browser window.
public string Title { get; }Gets or sets the URL the browser is currently displaying.
public string Url { get; set; }Gets the window handles of open browser windows.
public ReadOnlyCollection<string> WindowHandles { get; }Add a credential to the Virtual Authenticator/
public void AddCredential(Credential credential)credential Credential
The credential to be stored in the Virtual Authenticator
If credential is null.
If a Virtual Authenticator has not been added yet.
Creates a Virtual Authenticator.
public string AddVirtualAuthenticator(VirtualAuthenticatorOptions options)options VirtualAuthenticatorOptions
Authenticator id as string
If options is null.
Closes the Browser
Dispose()Dispose the WebDriver Instance
Dispose(bool)Stops the client from running
protected virtual void Dispose(bool disposing)disposing bool
if its in the process of disposing
Executes a command with this driver.
protected virtual Response Execute(string driverCommandToExecute, Dictionary<string, object>? parameters)driverCommandToExecute string
A DriverCommand value representing the command to execute.
parameters Dictionary<string, object>
A Dictionary<TKey, TValue> containing the names and values of the parameters of the command.
A Response containing information about the success or failure of the command and any data returned by the command.
If driverCommandToExecute is null.
Executes a command with this driver.
protected virtual Task<Response> ExecuteAsync(string driverCommandToExecute, Dictionary<string, object>? parameters)driverCommandToExecute string
A DriverCommand value representing the command to execute.
parameters Dictionary<string, object>
A Dictionary<TKey, TValue> containing the names and values of the parameters of the command.
A Response containing information about the success or failure of the command and any data returned by the command.
If driverCommandToExecute is null.
Executes JavaScript "asynchronously" in the context of the currently selected frame or window, executing the callback function specified as the last argument in the list of arguments.
public object? ExecuteAsyncScript(string script, params object?[]? args)script string
The JavaScript code to execute.
args object[]
The arguments to the script.
The value returned by the script.
Executes a command with this driver.
public object? ExecuteCustomDriverCommand(string driverCommandToExecute, Dictionary<string, object> parameters)driverCommandToExecute string
The name of the command to execute. The command name must be registered with the command executor, and must not be a command name known to this driver type.
parameters Dictionary<string, object>
A Dictionary<TKey, TValue> containing the names and values of the parameters of the command.
A Response containing information about the success or failure of the command and any data returned by the command.
The command returned an exceptional value.
Executes JavaScript in the context of the currently selected frame or window
public object? ExecuteScript(PinnedScript script, params object?[]? args)script PinnedScript
A PinnedScript object containing the JavaScript code to execute.
args object[]
The arguments to the script.
The value returned by the script.
If script is null.
Executes JavaScript in the context of the currently selected frame or window
public object? ExecuteScript(string script, params object?[]? args)script string
The JavaScript code to execute.
args object[]
The arguments to the script.
The value returned by the script.
Executes JavaScript in the context of the currently selected frame or window using a specific command.
protected object? ExecuteScriptCommand(string script, string commandName, params object?[]? args)script string
The JavaScript code to execute.
commandName string
The name of the command to execute.
args object[]
The arguments to the script.
The value returned by the script.
Finds the first element in the page that matches the By object
public IWebElement FindElement(By by)by By
By mechanism to find the object
IWebElement object so that you can interact with that object
IWebDriver driver = new InternetExplorerDriver();
IWebElement elem = driver.FindElement(By.Name("q"));If by is null.
Finds an element matching the given mechanism and value.
public virtual IWebElement FindElement(string mechanism, string value)mechanism string
The mechanism by which to find the element.
value string
The value to use to search for the element.
The first IWebElement matching the given criteria.
Finds the elements on the page by using the By object and returns a ReadOnlyCollection of the Elements on the page
public ReadOnlyCollection<IWebElement> FindElements(By by)by By
By mechanism to find the element
ReadOnlyCollection of IWebElement
IWebDriver driver = new InternetExplorerDriver();
ReadOnlyCollection<IWebElement> classList = driver.FindElements(By.ClassName("class"));Finds all elements matching the given mechanism and value.
public virtual ReadOnlyCollection<IWebElement> FindElements(string mechanism, string value)mechanism string
The mechanism by which to find the elements.
value string
The value to use to search for the elements.
A collection of all of the IWebElements matching the given criteria.
Gets the capabilities as a dictionary.
protected virtual Dictionary<string, object> GetCapabilitiesDictionary(ICapabilities capabilitiesToConvert)capabilitiesToConvert ICapabilities
The dictionary to return.
A Dictionary consisting of the capabilities requested.
If capabilitiesToConvert is null.
Retrieves all the credentials stored in the Virtual Authenticator
public List<Credential> GetCredentials()List of credentials
If a Virtual Authenticator has not been added yet.
Gets a Screenshot object representing the image of the page on the screen.
public Screenshot GetScreenshot()A Screenshot object containing the image.
Instructs the driver to change its settings.
ReturnsAn IOptions object allowing the user to change the settings of the driver.
Instructs the driver to navigate the browser to another location.
public INavigation Navigate()An INavigation object allowing the user to access the browser's history and to navigate to a given URL.
Performs the specified list of actions with this action executor.
public void PerformActions(IList<ActionSequence> actionSequenceList)actionSequenceList IList<ActionSequence>
The list of action sequences to perform.
Gets a PrintDocument object representing a PDF-formatted print representation of the page.
public PrintDocument Print(PrintOptions printOptions)printOptions PrintOptions
A PrintOptions object describing the options of the printed document.
The PrintDocument object containing the PDF-formatted print representation of the page.
If printOptions is null.
Close the Browser and Dispose of WebDriver
RegisterCustomDriverCommand(string, CommandInfo?)Registers a command to be executed with this driver instance.
public bool RegisterCustomDriverCommand(string commandName, CommandInfo? commandInfo)commandName string
The unique name of the command to register.
commandInfo CommandInfo
The CommandInfo object describing the command.
Registers a set of commands to be executed with this driver instance.
public void RegisterCustomDriverCommands(IReadOnlyDictionary<string, CommandInfo> commands)commands IReadOnlyDictionary<string, CommandInfo>
An IReadOnlyDictionary<TKey, TValue> where the keys are the names of the commands to register, and the values are the CommandInfo objects describing the commands.
Registers a command to be executed with this driver instance as an internally known driver command.
protected bool RegisterInternalDriverCommand(string commandName, CommandInfo? commandInfo)commandName string
The unique name of the command to register.
commandInfo CommandInfo
The CommandInfo object describing the command.
Removes all the credentials stored in the Virtual Authenticator.
public void RemoveAllCredentials()If a Virtual Authenticator has not been added yet.
Removes the credential identified by the credentialId from the Virtual Authenticator.
public void RemoveCredential(byte[] credentialId)credentialId byte[]
The id as byte array that uniquely identifies a credential
If credentialId is null.
If a Virtual Authenticator has not been added yet.
Removes the credential identified by the credentialId from the Virtual Authenticator.
public void RemoveCredential(string credentialId)credentialId string
The id as string that uniquely identifies a credential
If credentialId is null.
If a Virtual Authenticator has not been added yet.
Removes the Virtual Authenticator
public void RemoveVirtualAuthenticator(string authenticatorId)authenticatorId string
Id as string that uniquely identifies a Virtual Authenticator.
If authenticatorId is null.
Resets the input state of the action executor.
public void ResetInputState()Sets the isUserVerified property for the Virtual Authenticator.
public void SetUserVerified(bool verified)verified bool
The boolean value representing value to be set
Starts a session with the driver
protected void StartSession(ICapabilities capabilities)capabilities ICapabilities
Capabilities of the browser
Method to give you access to switch frames and windows
public ITargetLocator SwitchTo()Returns an Object that allows you to Switch Frames and Windows
IWebDriver driver = new InternetExplorerDriver();
driver.SwitchTo().Frame("FrameName");RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4