Customize Browser Driver Location
Last Modified:
Provar allows the customization of browser driver location for Chrome, Firefox, and Edge. When a custom driver location is specified, it takes precedence over the default settings, with the specified path logged for transparency.
Users-Defined paths will take priority over other defined values.
Driver Location Priority (Order of Resolution):
- User-Defined Path
- Custom path explicitly provided by the user (via environment variables, configuration files, or command-line arguments)
- Test Project’s lib Folder
- The folder within the test project directory where the driver is located
- User Home Directory
- .chromeDriver folder inside the {UserHome}/Provar directory, where the driver is auto-downloaded
- Default Installer Driver
- The driver is bundled with the Provar installation or a system-wide default driver
To define the custom path for drivers in Provar, the following options are available:
- Create an Environment Variable
- Edit the provar.properties File
- Edit the provar.ini File
- Pass as a Command-Line Argument
Note: The path value should specify the parent directory where the driver executable is located.
Create an Environment Variable
Create an Environment Variable by visiting the Variable tab in your Test Settings window. Click the plus sign in the top right corner to add a new variable.
Complete the Variable Name and Default Value fields to create the overriding path value.
The Variable Name is dependent on the browser.
Browser | Environment Variable Name |
Chrome | PROVAR_CHROMEDRIVER_PATH |
Edge | PROVAR_MSEDGEDRIVER_PATH |
Firefox | PROVAR_GECKODRIVER_PATH |
The Default Value should point to the user-defined, custom location.
In the example below, the Chrome driver is being directed to a folder in the Windows downloads directory.
Click OK to save your changes. You should see the variable listed as a way to confirm the entry. Double click the line item or select a entry and click the second edit icon to make changes.
Edit the provar.properties File
During the initial launch of Provar Automation, a .properties folder is created in the Provar UserHome with a blank provar.properties file inside. For windows, that can be found at C:\Users\<username>\Provar. For Mac, this is C:/Users/<username>/Provar.
Read about more feature flags and property configuration that can be set in this file.
To set a custom location for your driver in the provar.properties file, open the file in your favorite editor.
Create a new line in the file that begins with a variable for the corresponding browser you’d like to edit.
Browser | File Entry |
Chrome | com.provar.chromedriver.path |
Edge | com.provar.msedgedriver.path |
Firefox | com.provar.geckodriver.path |
Set the variable equal to your chosen location.
As before, in the example below, the Chrome driver is being directed to a folder in the Windows downloads directory.
Read about more feature flags and property configuration that can be set in this file.
Edit the provar.ini File
The provar.ini file can be directly edited to customize the driver locations by going to the Provar installation directory.
By default this is C:\ProgramFiles\Provar for Windows machines.
To find this folder for Mac, go to Provar in Applications. Right-click on the Provar application and choose Show Package Contents. Open Contents > Eclipse to locate the provar.ini file.
Read more about adding edit permissions to the provar.ini file.
Add the custom driver path entries in the provar.ini file by setting the supported property equal to the driver directory.
Browser | File Entry |
Chrome | -Dcom.provar.chromedriver.path |
Edge | -Dcom.provar.msedgedriver.path |
Firefox | -Dcom.provar.geckodriver.path |
Make sure to save changes to the file.
Pass as a Command Line Argument
Users may also include the custom driver path properties as command-line arguments while running through Apache Ant. As part of the ant command for the build.xml file, use the appropriate property to specify the customized location for your driver.
Browser | Command Line Argument |
Chrome | -Dcom.provar.chromedriver.path |
Edge | -Dcom.provar.msedgedriver.path |
Firefox | -Dcom.provar.geckodriver.path |
In the example below, the ant build.xml file is being run with the Firefox driver location argument directing the location to C:\Users\avalo\Downloads\geckodriver-v0.35.0-win-aarch64.
Discover more about running your tests under Apache Ant.
- Provar Automation
- System Requirements
- Browser and Driver Recommendations
- Installing Provar Automation
- Updating Provar Automation
- Licensing Provar
- Granting Org Permissions to Provar Automation
- Optimizing Org and Connection Metadata Processing in Provar
- Using Provar Automation
- Understanding Provar’s Use of AI Service for Test Automation
- Provar Automation
- Creating a New Test Project
- Import Test Project from a File
- Import Test Project from a Remote Repository
- Import Test Project from Local Repository
- Commit a Local Test Project to Source Control
- API Testing
- Behavior-Driven Development
- Consolidating Multiple Test Execution Reports
- Creating Test Cases
- Custom Table Mapping
- Functions
- Debugging Tests
- Defining a Namespace Prefix on a Connection
- Defining Proxy Settings
- Environment Management
- Exporting Test Cases into a PDF
- Exporting Test Projects
- Japanese Language Support
- Override Auto-Retry for Test Step
- Customize Browser Driver Location
- Mapping and Executing the Lightning Article Editor in Provar
- Managing Test Steps
- Namespace Org Testing
- NitroX
- Provar Test Builder
- ProvarDX
- Refresh and Recompile
- Reintroduction of CLI License Check
- Reload Org Cache
- Reporting
- Running Tests
- Searching Provar with Find Usages
- Secrets Management and Encryption
- Setup and Teardown Test Cases
- Tags and Service Level Agreements (SLAs)
- Test Cycles
- Test Data Generation
- Test Plans
- Testing Browser – Chrome Headless
- Testing Browser Options
- Tooltip Testing
- Using the Test Palette
- Using Custom APIs
- Callable Tests
- Data-Driven Testing
- Page Objects
- Block Locator Strategies
- Introduction to XPaths
- Creating an XPath
- JavaScript Locator Support
- Label Locator Strategies
- Maintaining Page Objects
- Mapping Non-Salesforce fields
- Page Object Operations
- ProvarX™
- Refresh and Reselect Field Locators in Test Builder
- Using Java Method Annotations for Custom Objects
- Applications Testing
- Provar Manager
- How to Use Provar Manager
- Provar Manager Setup
- Provar Manager Integrations
- Release Management
- Test Management
- Test Operations
- Provar Manager and Provar Automation
- Setting Up a Connection to Provar Manager
- Object Mapping Between Automation and Manager
- How to Upload Test Plans, Test Plan Folders, Test Plan Instances, and Test Cases
- Provar Manager Filters
- Uploading Callable Test Cases in Provar Manager
- Uploading Test Steps in Provar Manager
- How to Know if a File in Automation is Linked in Test Manager
- Test Execution Reporting
- Metadata Coverage with Manager
- Provar Grid
- DevOps
- Introduction to Provar DevOps
- Introduction to Test Scheduling
- Apache Ant
- Configuration for Sending Emails via the Automation Command Line Interface
- Continuous Integration
- AutoRABIT Salesforce DevOps in Provar Test
- Azure DevOps
- Running a Provar CI Task in Azure DevOps Pipelines
- Configuring the Automation secrets password in Microsoft Azure Pipelines
- Parallel Execution in Microsoft Azure Pipelines using Multiple build.xml Files
- Parallel Execution in Microsoft Azure Pipelines using Targets
- Parallel execution in Microsoft Azure Pipelines using Test Plans
- Bitbucket Pipelines
- CircleCI
- Copado
- Docker
- Flosum
- Gearset
- GitHub Actions
- Integrating GitHub Actions CI to Run Automation CI Task
- Remote Trigger in GitHub Actions
- Parameterization using Environment Variables in GitHub Actions
- Parallel Execution in GitHub Actions using Multiple build.xml Files
- Parallel Execution in GitHub Actions using Targets
- Parallel Execution in GitHub Actions using Test Plan
- Parallel Execution in GitHub Actions using Job Matrix
- GitLab Continuous Integration
- Travis CI
- Jenkins
- Execution Environment Security Configuration
- Provar Jenkins Plugin
- Parallel Execution
- Running Provar on Linux
- Reporting
- Salesforce DX
- Git
- Version Control
- Salesforce Testing
- Recommended Practices
- Salesforce Connection Best Practices
- Improve Your Metadata Performance
- Java 21 Upgrade
- Testing Best Practices
- Automation Planning
- Supported Testing Phases
- Provar Naming Standards
- Test Case Design
- Create records via API
- Avoid using static values
- Abort Unused Test Sessions/Runs
- Avoid Metadata performance issues
- Increase auto-retry waits for steps using a global variable
- Create different page objects for different pages
- The Best Ways to Change Callable Test Case Locations
- Working with the .testProject file and .secrets file
- Best practices for the .provarCaches folder
- Best practices for .pageObject files
- Troubleshooting
- How to Use Keytool Command for Importing Certificates
- Installing Provar After Upgrading to macOS Catalina
- Browsers
- Configurations and Permissions
- Connections
- DevOps
- Error Messages
- Provar Manager 3.0 Install Error Resolution
- Provar Manager Test Case Upload Resolution
- Administrator has Blocked Access to Client
- JavascriptException: Javascript Error
- macOS Big Sur Upgrade
- Resolving Failed to Create ChromeDriver Error
- Resolving Jenkins License Missing Error
- Resolving Metadata Timeout Errors
- Test Execution Fails – Firefox Not Installed
- Selenium 4 Upgrade
- Licensing, Installation and Firewalls
- Memory
- Test Builder and Test Cases
- Release Notes
- Provar AI Assistant Popup Test