Common errors in BAS and FingerprintSwitcher

[m4zuper]

We have prepared tables listing frequently encountered issues when working with the FingerprintSwitcher service and the visual logic constructor BrowserAutomationStudio. This information can help you quickly resolve problems or avoid common bugs in advance.

---

BrowserAutomationStudio

№	Error	Cause	Solution
1	net::ERR_SSL_PROTOCOL_ERROR	Network issues: incorrect proxy or SSL certificate	Check proxy settings (must support SSL), internet connection stability, and absence of blocks (e.g., firewall).
2	SyntaxError: Unable to Parse JSON String	Invalid JSON format (often due to corrupted user profile)	Delete and recreate the profile. Validate the JSON using an online validator.
3	Syntax error	Syntax error: incorrect use of variables, resources, or data types	Check the project for invalid characters in variable, resource, or function names. If using a database — recreate actions after updating it.
4	Element not found	Incorrect selector or insufficient element load waiting time	Ensure the selector (CSS, XPath, MATCH) matches the page structure. Add a wait for the element to appear. Use dynamic selectors.
5	Timeout error	Slow page load or complex script	Increase timeout in actions. Add error handling for network delays. Split the script into parts or simplify it.
6	BAS Crash	Memory overload or logical errors	Reduce load: close unnecessary tabs, disable heavy extensions. Look for infinite loops and logic errors. Add a 2–3 second delay at the start of the script.
7	Errors when updating and uploading projects to the server	Invalid characters in variable, resource, or function names	Remove smilies, Unicode characters, etc. from names, values, and descriptions for variables, functions, resources, and NodeJS actions.
8	NetworkAccessManager is not accessible. Try to create new browser with browser	Attempt to use the browser before opening it	Ensure browser-related actions occur only after the browser is launched.
9	Timeout during...	Action does not complete before the timeout expires	Try running BAS as administrator. Reduce the number of threads. Increase the timeout.
10	Captcha not displaying on the website	Official captcha-solving module enabled, interfering with display	Disable the module and check if the captcha appears.
11	Device memory fills up during project execution	Large number of temporary profiles	Check folders ...BrowserAutomationStudio\apps\...\prof or the path in the compiled project. Solutions: Disable profile caching, run BAS as administrator, relocate the project, and delete temporary profiles.
12	ReferenceError: Can't find variable	Undefined variable	Ensure the variable is defined before it is accessed. In multithreaded mode, use global variables or properly pass values between threads.
13	Selectors no longer display	A third-party fingerprint module is in use	Remove the old fingerprint module using the removal template.

---

FingerprintSwitcher

№	Error	Cause	Solution
1	Key Expired	FingerprintSwitcher key has expired	Update or correctly specify the FingerprintSwitcher key: check its expiration on fp.bablosoft.com, remove any extra characters.
2	Query limit reached	Request limit exceeded for the key	Try binding the key to an IP address on fp.bablosoft.com to increase the request limit.
3	Key Not Found	The key does not exist in the database	Verify the correctness of the entered key. You may be using an old or incorrect key.
4	Key is not allowed to use right now, try again later	Request limit exceeded for the key	This error may indicate the key is being used simultaneously in another project. It can also occur if a previous attempt to obtain a fingerprint was improperly interrupted (e.g., the fingerprint was in queue, but the action was manually stopped).