@applitools/driver 1.25.2 → 1.25.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.25.3](https://github.com/Applitools-Dev/sdk/compare/js/driver@1.25.2...js/driver@1.25.3) (2026-03-12)
+
+
+### Bug Fixes
+
+* enhance NML error messages for better user-facing diagnostics | FLD-4279 ([#3622](https://github.com/Applitools-Dev/sdk/issues/3622)) ([2aef039](https://github.com/Applitools-Dev/sdk/commit/2aef0395875fd0ff0b4f657d769bda23d66660ad))
+
+
+### Dependencies
+
+* @applitools/snippets bumped to 2.8.0
+  #### Features
+
+  * support coded regions within iframes and shadow DOM | FLD-4019 ([#3542](https://github.com/Applitools-Dev/sdk/issues/3542)) ([7c5639a](https://github.com/Applitools-Dev/sdk/commit/7c5639a8a4c135bc9331d9ff93f1824906549568))
+
 ## [1.25.2](https://github.com/Applitools-Dev/sdk/compare/js/driver@1.25.1...js/driver@1.25.2) (2026-03-08)
 
 

package/dist/driver.js

@@ -493,7 +493,11 @@ class Driver {
         (_a = (_b = this._state).nmlElement) !== null && _a !== void 0 ? _a : (_b.nmlElement = await this.waitFor({ type: 'accessibility id', selector: 'Applitools_View' }, { timeout: 10000 }).catch(() => null));
         if (!this._state.nmlElement) {
             this._logger.log('Broker url extraction is failed due to absence of nml element');
-            return null;
+            return {
+                error: 
+                // user facing error - doesn't mention broker on purpose to avoid confusion
+                'NML not found - please make sure that the Application has NML library instrumented or contact support for more details',
+            };
         }
         try {
             let result;
@@ -506,7 +510,8 @@ class Driver {
                 await utils.general.sleep(1000);
             } while (!result.error);
             this._logger.error('Broker url extraction has failed with error', result.error);
-            return null;
+            // user facing error - doesn't mention broker on purpose to avoid confusion
+            return { error: `NML initialization has failed with error: ${result.error}` };
         }
         catch (error) {
             this._logger.error('Broker url extraction has failed with error and will be retried', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/driver",
-  "version": "1.25.2",
+  "version": "1.25.3",
   "description": "Applitools universal framework wrapper",
   "keywords": [
     "applitools",
@@ -74,7 +74,7 @@
   },
   "dependencies": {
     "@applitools/logger": "2.2.9",
-    "@applitools/snippets": "2.7.1",
+    "@applitools/snippets": "2.8.0",
     "@applitools/utils": "1.14.2",
     "semver": "7.6.2"
   },

package/types/driver.d.ts

@@ -78,7 +78,9 @@ export declare class Driver<T extends SpecType> {
     getSessionId(): Promise<string | null>;
     getDriverUrl(): Promise<string | null>;
     getHelper(): Promise<HelperAndroid<T> | HelperIOS<T> | null>;
-    extractBrokerUrl(): Promise<string | null>;
+    extractBrokerUrl(): Promise<string | null | {
+        error: string;
+    }>;
     getSessionMetadata(): Promise<any | undefined>;
     getWorlds(): Promise<string[] | null>;
     getCurrentWorld(): Promise<string | null>;