Run Selenium tests with C# | BrowserStack Docs
Selenium with C#
Your guide to running tests using C# SDK on BrowserStack’s Selenium Grid of 3000+ real devices and desktop browsers.
This section covers running your first build with BrowserStack’s sample repo. To run builds with your existing test suite(s), skip to integrate your test suite.
Onboard faster with Test Companion
Launch in your IDE. Chat with the AI assistant to configure and run your first build instantly.
Prerequisites
BrowserStack Username and Access key. You can find this in your account profile section. If you do not have an account yet, sign up for a Free Trial.
Run a sample build
Run a sample C# test build, which is based on the NUnit, using your preferred method on BrowserStack:
Get sample project
Get our sample project by following these steps:
Download project
After downloading the sample project, unzip it in a desired location.
Import the downloaded project
Click File > Open. Navigate to your project and open it.
Configure your browserstack.yml config file
The browserstack.yml file holds all the required capabilities to run your tests on BrowserStack.
Set access credentials
Set userName and accessKey parameters in the browserstack.yml file, available in the root directory, to authenticate your tests on BrowserStack.
Select desktop browsers or real devices from a list of 3000+ available combinations:
Parallel thread
#1
Windows 10
Chrome 120
Parallel thread
#2
OS X Monterey
Safari 15.6
Parallel thread
#3
iOS 15
iPhone 13
Configure AI Agents
You can enable the following AI agents by adding the respective configurations in your browserstack.yml file:
Enable Self Heal Agent
Auto-fix locator failures with the AI-powered self-heal agent and get up to 40% fewer locator failures. Learn more
True
False
Test Failure Analysis Agent
Auto-enabled
AI-powered root cause analysis for test failures that can reduce debugging time. Learn more
Update the browserstack.yml config file
Replace the platforms object in the browserstack.yml file.
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
- YOUR_FIRST_OS_TYPE: YOUR_FIRST_OS
YOUR_FIRST_OS_VERSION_TYPE: YOUR_FIRST_OS_VERSION
YOUR_FIRST_BROWSER_TYPE: YOUR_FIRST_BROWSER
YOUR_FIRST_BROWSER_VERSION_TYPE: YOUR_FIRST_BROWSER_VERSION
- YOUR_SECOND_OS_TYPE: YOUR_SECOND_OS
YOUR_SECOND_OS_VERSION_TYPE: YOUR_SECOND_OS_VERSION
YOUR_SECOND_BROWSER_TYPE: YOUR_SECOND_BROWSER
YOUR_SECOND_BROWSER_VERSION_TYPE: YOUR_SECOND_BROWSER_VERSION
- YOUR_THIRD_OS_TYPE: YOUR_THIRD_OS
YOUR_THIRD_OS_VERSION_TYPE: YOUR_THIRD_OS_VERSION
YOUR_THIRD_BROWSER_TYPE: YOUR_THIRD_BROWSER
YOUR_THIRD_BROWSER_VERSION_TYPE: YOUR_THIRD_BROWSER_VERSION
browserstackLocal: true
buildName: browserstack-build-1
projectName: BrowserStack Sample
selfHeal: YOUR_SELF_HEAL
Run sample tests on BrowserStack!
Follow these steps to run your test on BrowserStack.
On the Visual Studio toolbar, select Test > Test Explorer.
Right-click on your test and click Run.
Get sample project
Get our sample project using one of the following options.
Option 1: Download the project
Option 2: Clone the Git repository
Clone our sample Git repository using these commands.
git clone https://github.com/browserstack/nunit-browserstack
cd nunit-browserstack
dotnet build
Run sample tests on BrowserStack!
Use the given command to run sample tests on BrowserStack.
dotnet test --filter "Category=sample-test"
After you run your test, visit the Automate dashboard to view your test results.
Next steps
After you have successfully run your first test on BrowserStack, try integrating your test suite with BrowserStack.