- getting started
Introduction: Cloud
Frequently Asked Questions
Telemetry
Testsigma Terminology
Testsigma Sample Applications
Command Center
- collaboration
Invite Team Members
Assign Projects
Users & Role Management
Review Management [Test Cases]
Review Management [Elements]
Execution Controls
Features & Scenarios
Manage Test Cases
Test Case List Actions
Import Test Project Test Cases
Importing Postman Collections and Environments
Update Test Case Result in a Test Plan
Test Cases (Mobile Web App)
Custom Fields for Test Cases
Label Management
- Test Step Types
Type: Natural Language
Type: REST API
Type: Step Group
Type: For Loop
Type: While Loop
Type: Block
Type: If Condition
Nested Step Groups
Image Injection
Cross-application testing
- Test Data Types
Raw
Parameter
Runtime
Random
Data Generator
Phone Number
Mail Box
Environment
Concat Test Data
Create Test Data Profile
Update Test Data Profile
Updating Value in TDP
Import TDP
Bulk Deletion of a Test Data Profile
Create Test Data [Environment]
- data generators
Default Test Data Generators
Address Function Type
ChangeDataType Function Type
Company Function Type
DateFunctions Function Type
DomainFunctions Function Type
EmailFunctions Function Type
File Function Type
Friends Function Type
IdNumber Function Type
Internet Function Type
MailboxAliasFunctions Function Type
MailboxFunctions Function Type
Name Function Type
NameFunctions Function Type
Number Function Type
NumberFunctions Function Type
Phone Number Function Type
PhoneNumberFunctions Function Type
Random String Function Type
RandomText Function Type
StringFunctions Function Type
TestDataFromProfile Function Type
- Elements (Objects)
- Web Applications
Record Single Element
Record Multiple Elements
Create Elements
Supported Locator Types
Formulating Elements
Shadow DOM Elements
Verifying elements in Chrome DevTools
Handling iframe Elements?
Create Image Based Elements
Dynamic Locators using Parameter
Dynamic Locators using Runtime
Using Environment Test Data for Dynamic Locators
Locating Dynamic Elements in Date Widget
Freeze & Inspect Dynamic Elements (WebPage)
Locating Dynamic Elements in Tables
Import/Export Elements
AI Enabled Auto-Healing
Locator Precedence (Web Apps)
Verify Elements from Test Recorder
- test step recorder
Install Chrome Extension
Install Firefox Extension
Install Edge Extension
Exclude Attributes/Classes
- test plans
Add, Edit, Delete Test Machines
Add, Edit, Delete Test Suites
Schedule Test Plans
Run Test Suites In Parallel
Cross Browser Testing
Distributed Testing
Headless Testing
Test Lab Types
Disabling Test Cases in Test Plans
AfterTest Case
Post Plan Hook
AfterTest Suite
Email Configuration in Test Plan
Execute Partial Test Plans via API
- runs
Ad-hoc Run
Test Plan Executions
Dry Runs on Local Devices
Run Tests on Private Grid
Run Tests on Vendor Platforms
Run Test Plans on Local Devices
Test Locally Hosted Applications
Debug Test Case Failures
Parallel and Allowed queues
- live editor
Introduction: Testsigma Terminal
Installing Testsigma Terminal
Editing a Test Case Using Live Editor
FAQs on Testsigma Terminal
- Testsigma Agent
Pre-requisites
Setup: Windows, Mac, Linux
Setup: Android Local Devices
Setting up iOS Local Devices
Update Agent Manually
Update Drivers Manually
Delete Corrupted Agent
Delete Agents: Soft & Permanent
Triggering Tests on Local Devices
- troubleshooting
Agent - Startup and Registration Errors
Agent Logs
Upgrade Testsigma Agent Automatically
Specify Max Sessions for Agents
Testsigma Agent - FAQs
- continuous integration
Test Plan Details
REST API (Generic)
Jenkins
Azure DevOps
AWS DevOps
AWS Lambda
Circle CI
Bamboo CI
Travis CI
CodeShip CI
Shell Script(Generic)
Bitrise CI
GitHub CI/CD
Bitbucket CI/CD
GitLab CI/CD
Copado CI/CD
Gearset CI/CD
Codemagic CI/CD
- desired capabilities
Most Common Desired Capabilities
Browser Console Debug Logs
Geolocation Emulation
Bypass Unsafe Download Prompt
Geolocation for Chrome & Firefox
Custom User Profile in Chrome
Emulate Mobile Devices (Chrome)
Add Chrome Extension
Network Throttling
Network Logs
Biometric Authentication
Enable App Resigning in iOS
Enable Capturing Screenshots (Android & iOS)
Configure Android WebViews
Incognito/Private mode
Set Google Play Store Credentials
Basic Authentication [Safari]
- addons
What is an Addon?
Addons Community Marketplace
Install and Use Community Addons in Testsigma
Prerequisites for creating add-ons
Create an Addon
Update Addon
Addon Types
Create a Post Plan Hook add-on in Testsigma
Create OCR Text Extraction Addon
- configuration
API Keys
- Security(SSO)
Setting Up Google Single Sign-On(SSO) Login in Testsigma
Setting Up Okta Single Sign-On Integration with SAML Login in Testsigma
Setting up SAML-based SSO login for Testsigma in Azure
iOS Settings
Create WDA File
SMTP Configuration
Manage Access
- uploads
Upload Files
Upload Android and iOS Apps
How to generate mobile builds for Android/iOS applications?
- Testsigma REST APIs
Manage Environments
Elements
Test Plans
Upload Files
Get Project Wide Information
Upload & Update Test Data Profile
Fetch Test Results (All Levels)
Trigger Multiple Test Plans
Trigger Test Plans Remotely & Wait Until Completion
Run the Same Test Plan Multiple Times in Parallel
Schedule, Update & Delete a Test Plan Using API
Update Test Case Results Using API
Create and update values of Test Data Profile using REST API
Rerun Test Cases from Run Results using API
Salesforce Metadata Refresh Using API
- open source dev environment setup
macOS and IntelliJ Community Edition
macOS and IntelliJ Ultimate Edition
Windows and IntelliJ Ultimate Edition
Setup Dev Environment [Addons]
- NLPs
Retrieve Value in Text Element
Capture Dropdown Elements
Unable to Select Radiobutton
Unable to Click Checkbox
Clearing the Session or Cookies
UI Identifier NLP
Drag & Drop NLP
Uploading Files NLP
Use MySQL Addon in NLPs
- setup
Server Docker Deployment Errors
Secured Business Application Support
Troubleshooting Restricted Access to Testsigma
Why mobile device not displayed in Testsigma Mobile Test Recorder?
Unable to Create New Test Session
Agent Startup Failure Due to Used Ports
Tests Permanently Queued in Local Executions
Fix Testsigma Agent Registration Failures
Testsigma Agent Cleanup
Need of Apache Tomcat for Testsigma Agent
- web apps
URL not accessible
Test Queued for a Long Time
Issues with UI Identifiers
Missing Elements in Recorder
Collecting HAR File
Errors with Browser Session
Page Loading Issues
- mobile apps
Failed to Start Mobile Test Recorder
Troubleshooting “Failed to perform action Mobile Test Recorder” error
Why Test Execution State is Queued for a Long Time?
Why Mobile App Keeps Stopping After Successful Launch?
More pre-requisite settings
Why am I not able to start WDA Process on iPhone?
What are the Most Common causes for Click/Tap NLP Failure?
How to Find App Package & Activity in Android?
Cross-environment Compatible ID Locators (Android)
Why Accessibility IDs Over other Locators?
What are Common Android Issues & Proposed Solutions?
How to Find the App Bundle ID for iOS?
Developer Mode (iOS 16 & Above)
How to Handle iOS App Compatibility Issues?
How to Disable Play Protect for SMS Forwarder Installation?
How to Capture Network Logs in an Android Application?
- web apps
Why Install Chrome Extension?
Steps to Test Locally Hosted Apps
How to Turnoff Onboading Tutorial?
Non-Text Keys in Test Cases
Basic Authentication for Web
Why Bypass CAPTCHA?
Test Case Failures Due to Link Text Capture Issues
Why Is a Single Video for All Test Cases in a Test Plan Unavailable in Some Cases?
- accessibility testing
Accessibility Testing for Web Applications
Accessibility Testing for Android & iOS
- salesforce testing
Intro: Testsigma for Salesforce Testing
Creating a Connected App
Creating a Salesforce Project
Test Salesforce Connection Before Authorization
Creating Metadata Connections
Adding User Connections
Build Test Cases: Manual+Live
Salesforce Element Repositories
Intro: Testsigma Special NLPs
SOQL as Test Step
Query Builder for Salesforce Testing
Automating Listview Table NLPs
Error Handling On Metadata Refresh
Introduction: SAP Automation
Selective Element Recorder
Batch Element Recorder
Creating Test Cases for SAP Automation
List of Actions
- desktop automation
Introduction: Desktop Automation
Create Projects and Applications
Selective Element Recorder
Batch Element Recorder
Creating Test Cases for Desktop Automation
Intro: Windows Automation (Lite)
Windows (Lite) Project & Application
Element Learning with Test Recorder
Test Cases for Windows (Lite)
- GenAI Capabilities
Testsigma Copilot
Generate TDP Using Copilot
Generate Tests from User Actions
Generate Tests from Requirements (Jira)
Generate API Test Cases (Swagger)
Generate Tests from Figma Designs
Testsigma Copilot for Mobile Apps
Agentic Test Generation with GitHub
Intro: Windows Desktop Automation
Windows (Adv) Project & Application
Object Learning (Using UFT One)
Converting TSR Files to TSRx
Importing/Updating TSRx Files
Test Cases for Windows Automation
Error Handling Post TSRx File Update
- testsigma tunnel
Intro: Testsigma Tunnel
Components & Requirements
Setup and Installation: Mac
Setup and Installation: Windows
Setup and Installation: Linux
Setup and Installation: Docker
Using Testsigma Tunnel
- open source docs
Intro: Testsigma Community Edition
Testsigma Community Cloud
Testsigma Docker Setup
Reset Password
Troubleshooting Agent Startup & Registration Errors
If the Agent is not starting, or is starting and terminating immediately, see the Agent logs for details. For more information refer to, fetching Agent logs. If you need some help understanding the error from the logs, reach out to support.
The below sections discusses common errors and troubleshooting suggestions:
1. Port not available
By default, Testsigma automatically detects the available ports. If you encounter the error Port not available you can manually check the availability of the ports 8383 and 8484 using the below commands:
Linux
Use the below command in terminal for Linux/Unix
lsof -i :8383
Try the same command with port numbers 8484 as well.
Windows
For Windows, try the below command in Powershell:
Get-Process -Id
(Get-NetTCPConnection -LocalPort 8383).OwningProcess
Try the same command with the port numbers 8484.
If no ports are available,try the below steps to free up the ports
Windows
- Open CMD with Admin privileges (Run as Administrator).
- Find the process that's using the required port. Use the below command to find the processes running on port 8383:
netstat -ano | findstr :8383
You will see the following output:
The last field with the five-digit number is the Process ID(PID). - Now that we have got the PID for the process, we can send a kill signal.
taskkill /PID typeyourPIDhere /F
Once the port is free Testsigma automatically detects the available port.
- If the Testsigma agent does not start immediately repeat the same command in Step 2 and confirm the result is empty.
- Try the above steps for port 8484 as well.
Linux and macOS
- Open Terminal.
- Find the process that's running on the required port. Use the below command to find the processes using the port 8080:
netstat -anop | grep :8383
You will see the following output: - The second last field with 4/5 digits is the Process ID(PID) and the name after the '/' is the process name.
- Now that we have got the PID for the process, we can send a process termination signal using pkill
pkill typeyourPIDhere
- Repeat the same command in Step 2 and confirm the result is empty. If the process is still present, use the below command to force kill using kill
kill -SIGKILL typeyourPIDhere
- Repeat the same steps for other ports 8484 as well.
2. Unable to register
Once the Testsigma Agent is started, Testsigma Agent web UI is accessible at
http://localhost:8383/agent
(HTTP) ORhttps://local.testsigmaagent.com:8484/agent/
(HTTPS).
Try accessing the above localhost URLs after starting the agent.
The reason behind doing so is to understand if the agent is accessible and has all permission from the system administrator. If this is not accessible, it indicates that there is some hindrance in the system like firewall blocks or certain antivirus blocking the access. In such conditions, you may contact your IT Team for help.
If the above pages are accessible, proceed to the next step.
But if https://local.testsigmaagent.com:8484/agent/
is unreachable but http://127.0.0.1:8383/agent/
is reachable, the following entry needs to be added to hosts file:
127.0.0.1 local.testsigmaagent.com
Windows
In Windows, the hosts file is located at C:\Windows\System32\Drivers\etc\hosts.
- Right click on Notepad in the Start menu and select Run as Administrator. This is crucial to ensure you can make the required changes to the file. Now click File > Open and browse to : c:\Windows\System32\Drivers\etc\hosts.
macOS and Linux
On macOS and Linux, the host file is located at /etc/hosts. You may need superuser privileges (sudo) to edit this file.
- Open Terminal.
- Type sudo nano /etc/hosts
- When you’re done adding the entry, use Ctrl + O (followed by Enter) to save the file and then Ctrl + X to exit.
3. Certificate errors
This error on the Agent logs will also help you understand there is a firewall blockage from your network side:
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
at java.base/sun.security.ssl.Alerts.getSSLException(Alerts.java:198)
at java.base/sun.security.ssl.SSLSocketImpl.fatal(SSLSocketImpl.java:196
4. Permission issues
Sometimes while trying to register the Testsigma Agent, we might face errors due to our system's security settings. This usually happens when your system's privacy settings do not Allow apps downloaded from App Store and Identified developers. Follow the below steps to troubleshoot the errors.
Mac
- Navigate to your Privacy settings :
Apple menu > System Preferences > click Security & Privacy > click General. - Under the General tab, change the privacy settings to Allow apps downloaded from App Store and Identified developers after giving the system's credentials.
Windows
- Search for Allowed apps settings in the search box.
- Once you are in the Allowed Apps, change the privacy settings to Allow apps downloaded from App Store and Identified developers after giving the system's credentials.
Try the agent registration process once again after restarting the agent.
5. Agent out of sync
Follow the below steps to fix the issue.
- Refresh the Testsigma app.
- Restart the Agent.
- If the Agent is not updated, update the Agent. For more information, refer to update Agents.
If the above troubleshooting steps does not resolve the issue, contact Testsigma support at support@testsigma.com with the Agent logs files. For more information on how to fetch agent logs refer to, agent logs.
6. Server connection failed
This occurs because Testsigma Agent cannot reach our servers.It might be due to connection issue or proxy errors. Ensure app.testsigma.com is reachable.
7. Proxy Error
If a proxy is configured for your network, whitelist the domains app.testsigma.com and local.testsigmaagent.com.
If proxy configuration is added in your operating system settings and whitelisting app.testsigma.com and local.testsigmaagent.com in the system proxy settings does not work,
add the following parameter in a configuration file in TestsigmaAgent installation directory.
Windows:
Add wrapper.java.additional.9=-Djava.net.useSystemProxies=true
at the end of Java Additional Parameters section in
<INSTALLATION-FOLDER>/wrapper/conf/wrapper-script-custom.conf
- If Agent is installed using .exe file, <INSTALLATION-FOLDER> is by default at C:\Testsigma\TestsigmaAgent.
- If Agent is extracted from ZIP file, <INSTALLATION-FOLDER> is the folder into which ZIP is extracted.
macOS
Add wrapper.java.additional.9=-Djava.net.useSystemProxies=true at the end of Java Additional Parameters section in <INSTALLATION-FOLDER>/wrapper/conf/wrapper-custom.conf
- If Agent is installed using DMG file, <INSTALLATION-FOLDER> is by default at
/Applications/TestsigmaAgent.app/Contents/Resources/wrapper/conf
. - If Agent is extracted from ZIP file, <INSTALLATION-FOLDER> is the folder into which ZIP is extracted.
Linux
Add wrapper.java.additional.15=-Djava.net.useSystemProxies=true at the end of Java Additional Parameters section in <INSTALLATION-FOLDER>/wrapper/conf/wrapper-custom.conf
<INSTALLATION-FOLDER> is the folder into which ZIP or bin is extracted.