> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/agent-release-notes/nodejs-technologies/nodejs-browser-agent.md).

# NodeJS/Browser Agent

## 2026 Release Notes

<table><thead><tr><th width="116.38671875">Version</th><th width="169.59375">Date</th><th>Changes</th></tr></thead><tbody><tr><td>6.2.24</td><td>June 16, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added support for test execution details from an external context in the browser agent.</li><li>Added support for the <code>SL_PROXY</code> environment variable in the preloader script.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Bumped dependency version to address a security vulnerability.</li></ul></td></tr><tr><td>6.2.19</td><td>May 27. 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed a browser agent issue where coverage was not reported for dynamically loaded JavaScript files in applications using on-demand module loading.</li></ul></td></tr><tr><td>6.2.15</td><td>May 13, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed an issue where files with URL-scheme paths were not properly excluded during build scanning.</li><li>Improved path handling for Windows environments during the scanning process.</li></ul></td></tr><tr><td>6.2.12</td><td>May 5, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Extended all test runners to include group context in execution completion reporting.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed build-scanning issues that could result in missing server-side coverage for certain bundled application setups.</li><li>Improved source path resolution to correctly handle non-standard path formats encountered during scanning.</li></ul></td></tr><tr><td>6.2.8</td><td>Apr 27, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Updated the Mocha executor to use direct API calls for execution lifecycle management.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Fixed a module initialization issue causing unintended side effects on import.</li></ul></td></tr><tr><td>6.2.6</td><td>Apr 9, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Addressed several CLI configuration inconsistencies introduced in a prior release.</li><li>Improved error handling for unexpected server responses during agent initialization.</li></ul></td></tr><tr><td>6.2.1</td><td>Mar 30, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Standardized CLI parameter names to align with other SeaLights agents:<br><code>--branchName</code>, <code>--buildName</code>, <code>--failOnError</code>, <code>--scanDir</code>, <code>--scmType</code>, <code>--excludeFiles</code>, <code>--moduleName</code>, <code>--repositoryUrl</code>, <code>--disableTia</code>, <code>--file</code>, and <code>--filesFolder</code>.</li><li><p>Added command aliases for improved usability:</p><ul><li><code>completeScan</code></li><li><code>openTestStage</code> / <code>startTestStage</code></li><li><code>closeTestStage</code> / <code>endTestStage</code></li></ul></li><li>Maintained full backward compatibility by preserving all existing parameter and command names as aliases.</li><li>Allowed all agent parameters to be overridden via the SeaLights backend. Track overrides with cockpit messages and debug logs for visibility, ensuring parity with other agents.</li><li>Refactored CLI and configuration system. Maintained full compatibility with existing scripts and integrations.</li></ul><p><strong>Resolved Issues:</strong></p><ul><li>Addressed an issue where the default <code>excludedFiles</code> glob pattern (e.g., <code>test/**/*</code>) matched a file instead of a directory, causing <code>fs.statSync</code> to throw <code>ENOTDIR</code>. Now safely skips unresolvable paths.</li></ul></td></tr><tr><td>6.1.1163</td><td>Mar 9, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Updated <code>engines</code> field in <code>package.json</code> to <code>>= Node 16.x</code>.</li></ul></td></tr><tr><td>6.1.1162</td><td>Mar 3, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added default <code>.slignore.instrument</code> for various frontend frameworks.</li></ul></td></tr><tr><td>6.1.1160</td><td>Feb 24, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Bumped <code>sl-request</code> to 1.0.8 and overrode <code>ajv</code> to 8.18.0 to resolve a high-severity vulnerability.</li></ul></td></tr><tr><td>6.1.1159</td><td>Feb 16, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Updated dependencies to use newer version of <code>qs</code> (latest: 6.14.1) to remove Snyk-reported vulnerability.</li></ul></td></tr><tr><td>6.1.1158</td><td>Feb 16, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Prevented <code>CockpitNotifier</code> errors from appearing in the console.</li></ul></td></tr><tr><td>6.1.1154</td><td>Feb 10, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li><code>--excludeSourceMapFiles</code> now allows skipping copying of source map files to instrumentation output and optionally deleting them from the workspace directory. Previously worked only for <code>.js.map</code> files; now also works for <code>.css.map</code>.</li></ul></td></tr><tr><td>6.1.1153</td><td>Feb 5, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Fixed failure to embed <code>sl-mapping</code> for pure JavaScript files (without source maps). Previously, this caused coverage to not appear.</li></ul></td></tr><tr><td>6.1.1152</td><td>Feb 4, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added a cache-busting mechanism when using a preamble file. Cached deployment files containing an outdated <code>buildSessionId</code> are now automatically synchronized when a new <code>buildSessionId</code> is detected in the preamble file.</li></ul></td></tr><tr><td>6.1.1151</td><td>Feb 3, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added console messages across all relevant <code>slnodejs</code> commands, including the Mocha test runner.</li><li>Added a console message for the existing validation that checks whether a build already exists for the specified <code>buildSessionId</code>.</li><li>Moved selected lifecycle logs to the <strong>info</strong> level to avoid duplication with console output.</li></ul></td></tr><tr><td>6.1.1150</td><td>Jan 27, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added support for the <code>prId</code> parameter in the Mocha executor.</li><li>Introduced an API to manually load executions in the remote-agent.</li><li>Introduced an API to manually set TIA status in the remote-agent.</li></ul></td></tr><tr><td>6.1.1147</td><td>Jan 13, 2026</td><td><p><strong>Resolved Issues:</strong></p><ul><li>Removed obsolete Footprints v5 code from the agent.</li></ul></td></tr><tr><td>6.1.1143</td><td>Jan 13, 2026</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added support for running the remote-agent with compressed sl-mapping files.</li></ul></td></tr></tbody></table>

## 2025 Release Notes

<table><thead><tr><th width="116.19140625">Version</th><th width="169.9921875">Date</th><th>Changes</th></tr></thead><tbody><tr><td>6.1.1142</td><td>Dec 17, 2025</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added a public method to allow the remote-agent to send the Agent Started event.</li></ul></td></tr><tr><td>6.1.1140</td><td>Dec 17, 2025</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added an <code>isRunning</code> flag to the remote-agent to prevent redundant start or stop calls when the agent state has not changed.</li></ul></td></tr><tr><td>6.1.1133</td><td>Dec 5, 2025</td><td><p><strong>New Features and Updates:</strong></p><ul><li>Added a warning message in both the console and the Cockpit when a scan detects the same methods being scanned more than once.</li><li>Included <code>executionId</code> in all relevant HTTP requests, both in root headers and request metadata.</li><li>Updated the Mocha executor and <code>nycReport</code> to skip loading the default <code>buildSessionId</code> file when <code>labId</code> is provided.</li><li>Aligned Mocha behavior to continue supporting the default <code>buildSessionId</code> file only when <code>labId</code> is not provided.</li></ul></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sealights.io/knowledgebase/agent-release-notes/nodejs-technologies/nodejs-browser-agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.