|
| 1 | +--- |
| 2 | +subject: Browser agent |
| 3 | +releaseDate: "2025-11-13" |
| 4 | +version: 1.303.0 |
| 5 | +downloadLink: https://www.npmjs.com/package/@newrelic/browser-agent |
| 6 | +features: ["Allow consent API to be invoked without localStorage access","Allow nested registrations","Additional validation to prepare agent for MFE registrations","Add measure support to register API","Add useConsentModel functionality","Retry initial connect call","Add custom event support to register API","SMs for browser connect response"] |
| 7 | +bugs: ["Obfuscate custom attributes for logs added after PVE","memoize promise context propagation to avoid safari hangs"] |
| 8 | +security: [] |
| 9 | +--- |
| 10 | + |
| 11 | +## v1.303.0 |
| 12 | + |
| 13 | +### Features |
| 14 | + |
| 15 | +#### Allow consent API to be invoked without localStorage access |
| 16 | +Allows the consent API to function without requiring localStorage access, by keeping common state in the agent that controls harvests. Applications must invoke the API on every hard page load when localStorage access is blocked. |
| 17 | + |
| 18 | +#### Allow nested registrations |
| 19 | +To facilitate inherent parent-child relationships with the planned register API, allow registered entities to expose their own `.register()` API for children of that entity to register with. Entities who register with the container agent will be related to the container. Entities that register under another registered entity will be related to both the container as well as the parent entity. |
| 20 | + |
| 21 | +#### Additional validation to prepare agent for MFE registrations |
| 22 | +Adding validation rules in the agent to prevent bad values for MFE target `id` and `name` in support of MFE/v2 registrations. |
| 23 | + |
| 24 | +#### Add measure support to register API |
| 25 | +Adds support for the measure API in the register response object. This is in support of the future micro front end offering planned. |
| 26 | + |
| 27 | +#### Add useConsentModel functionality |
| 28 | +Adds use_consent_mode init property and functionality. Adds the consent() API call. The consent model, if enabled, disallows agent harvesting unless consent is given through the consent() API call. |
| 29 | + |
| 30 | +#### Retry initial connect call |
| 31 | +To help prevent data loss, the agent will now retry the original "RUM" call an extra time for retryable status codes. |
| 32 | + |
| 33 | +#### Add custom event support to register API |
| 34 | +Adds methods for capturing custom events to the register API, to be used later when MFE support is established. |
| 35 | + |
| 36 | +#### SMs for browser connect response |
| 37 | +Adds supportability metrics for failed responses on initializing the page_view_event aggregate. |
| 38 | + |
| 39 | + |
| 40 | +### Bug fixes |
| 41 | + |
| 42 | +#### Obfuscate custom attributes for logs added after PVE |
| 43 | +Extends obfuscation to cover custom attributes on logging events added after the initial RUM/PageViewEvent harvest. |
| 44 | + |
| 45 | +#### memoize promise context propagation to avoid safari hangs |
| 46 | +Memoizes promise context propagation to prevent potential browser hangs in Safari by avoiding repeated context operations. |
| 47 | + |
| 48 | +## Support statement |
| 49 | + |
| 50 | +New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach [end-of-life](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). Release dates are reflective of the original publish date of the agent version. |
| 51 | + |
| 52 | +New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this [status dashboard](https://newrelic.github.io/newrelic-browser-agent-release/) for more information. |
| 53 | + |
| 54 | +Consistent with our [browser support policy](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), v1.303.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 131-141, Edge 131-141, Safari 17-26, and Firefox 134-144. For mobile devices, v1.303.0 was built and tested for Android OS 16 and iOS Safari 17-26. |
0 commit comments