@newrelic/browser-agent 1.292.0 → 1.292.1-rc.1

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.292.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.292.0...v1.292.1) (2025-06-26)
+
+
+### Bug Fixes
+
+* fix custom attribute race condition precedence ([#1507](https://github.com/newrelic/newrelic-browser-agent/issues/1507)) ([969f634](https://github.com/newrelic/newrelic-browser-agent/commit/969f634f4d22f112f3aba2fc2e74d6959dafbae5))
+
 ## [1.292.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.291.1...v1.292.0) (2025-06-16)
 
 

package/README.md

@@ -86,14 +86,63 @@ The following features may be disabled by adding `init` entries as shown above.
 - `ajax`
 - `generic_events`
 - `jserrors`
+- `logging`
 - `metrics`
 - `page_view_timing`
 - `session_replay`
 - `session_trace`
+- `soft_navigations`
 - `spa`
 
+***Individual event types within the `generic_events` feature can also be disabled. See [Disabling Individual Generic Events](#disabling-individual-generic-events)***
+
 See the [New Relic documentation site](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/introduction-browser-monitoring/) for information on the above features.
 
+### Disabling Individual Generic Events
+The following event types reported by the `generic_events` feature can be individually disabled in the `init` configuration.
+
+#### Page Actions
+```javascript
+const options = {
+  info: { ... },
+  loader_config: { ... },
+  init: {
+    page_action: {enabled: false}
+    ...
+  }
+}
+```
+
+#### User Actions
+```javascript
+const options = {
+  info: { ... },
+  loader_config: { ... },
+  init: {
+    user_actions: {enabled: false}
+    ...
+  }
+}
+```
+
+#### Performance (Marks, Measures, Resources)
+```javascript
+const options = {
+  info: { ... },
+  loader_config: { ... },
+  init: {
+    performance: {
+      capture_marks: false, // disable performance mark collection
+      capture_measures: false, // disable performance measure collection
+      resources: {
+        enabled: false // disable performance resource collection
+      }
+    }
+    ...
+  }
+}
+```
+
 ## Options Parameter
 
 The `options` parameter used, or passed in, when instantiating the `BrowserAgent` class can include the following arguments:
@@ -118,6 +167,23 @@ The examples above use the `BrowserAgent` class, which is the best option for mo
 
 Using the base `Agent` class, it is also possible to compose a custom agent by passing an array called `features` in the `options` object, containing only the desired feature modules. Depending on which features are included, this may yield a smaller loader script and improved performance.
 
+The following feature modules are available for inclusion in the `features` array:
+
+```javascript
+import { Ajax } from '@newrelic/browser-agent/features/ajax';
+import { GenericEvents } from '@newrelic/browser-agent/features/generic_events';
+import { JSErrors } from '@newrelic/browser-agent/features/jserrors';
+import { Logging } from '@newrelic/browser-agent/features/logging';
+import { Metrics } from '@newrelic/browser-agent/features/metrics';
+import { PageViewEvent } from '@newrelic/browser-agent/features/page_view_event';
+import { PageViewTiming } from '@newrelic/browser-agent/features/page_view_timing';
+import { SessionReplay } from '@newrelic/browser-agent/features/session_replay';
+import { SessionTrace } from '@newrelic/browser-agent/features/session_trace';
+import { SoftNav } from '@newrelic/browser-agent/features/soft_navigations';
+import { Spa } from '@newrelic/browser-agent/features/spa';
+```
+
+### Example 1 - "Page Load Agent"
 The example below includes three feature modules: `Metrics`, `PageViewEvent`, and `PageViewTiming`.
 
 ```javascript
@@ -142,17 +208,39 @@ new Agent({
 })
 ```
 
-The following feature modules are available for inclusion in the `features` array:
+### Example 2: "Custom Events Agent"
+The example below builds an agent that only allows custom events (`.recordCustomEvent(...)`) and does not automatically detect any other event types besides a PageView event (required). It also [disables the automatic collection of certain generic events](#disabling-individual-generic-events) to ensure only manual events are captured.
 
 ```javascript
-import { Ajax } from '@newrelic/browser-agent/features/ajax';
-import { JSErrors } from '@newrelic/browser-agent/features/jserrors';
-import { Metrics } from '@newrelic/browser-agent/features/metrics';
+import { Agent } from '@newrelic/browser-agent/loaders/agent'
 import { GenericEvents } from '@newrelic/browser-agent/features/generic_events';
-import { PageViewEvent } from '@newrelic/browser-agent/features/page_view_event';
-import { PageViewTiming } from '@newrelic/browser-agent/features/page_view_timing';
-import { SessionTrace } from '@newrelic/browser-agent/features/session_trace';
-import { Spa } from '@newrelic/browser-agent/features/spa';
+
+const options = {
+  info: { ... },
+  loader_config: { ... },
+  init: { 
+    // disable the automatic collection of UserAction events
+    user_actions: {enabled: false},
+    // disable the automatic collection of BrowserPerformance events
+    performance: {
+      capture_marks: false,
+      capture_measures: false,
+      resources: {enabled: false}
+    }
+  }
+}
+
+const browserAgent = new Agent({
+  ...options,
+  features: [
+    GenericEvents
+  ]
+})
+
+// manually capture page actions
+browserAgent.addPageAction(...)
+// manually capture custom events
+browserAgent.recordCustomEvent(...)
 ```
 
 ## Deploying one or more "micro" agents per page

package/dist/cjs/common/constants/env.cdn.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.292.0";
+const VERSION = exports.VERSION = "1.292.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.npm.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.292.0";
+const VERSION = exports.VERSION = "1.292.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/features/utils/agent-session.js

@@ -30,9 +30,10 @@ function setupAgentSession(agentRef) {
   // Retrieve & re-add all of the persisted setCustomAttribute|setUserId k-v from previous page load(s), if any was stored.
   const customSessionData = agentRef.runtime.session.state.custom;
   if (customSessionData) {
+    /** stored attributes from previous page should not take precedence over attributes stored on this page via API before the page load */
     agentRef.info.jsAttributes = {
-      ...agentRef.info.jsAttributes,
-      ...customSessionData
+      ...customSessionData,
+      ...agentRef.info.jsAttributes
     };
   }
   const sharedEE = _contextualEe.ee.get(agentRef.agentIdentifier);

package/dist/esm/common/constants/env.cdn.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.292.0";
+export const VERSION = "1.292.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/constants/env.npm.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.292.0";
+export const VERSION = "1.292.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/features/utils/agent-session.js

@@ -23,9 +23,10 @@ export function setupAgentSession(agentRef) {
   // Retrieve & re-add all of the persisted setCustomAttribute|setUserId k-v from previous page load(s), if any was stored.
   const customSessionData = agentRef.runtime.session.state.custom;
   if (customSessionData) {
+    /** stored attributes from previous page should not take precedence over attributes stored on this page via API before the page load */
     agentRef.info.jsAttributes = {
-      ...agentRef.info.jsAttributes,
-      ...customSessionData
+      ...customSessionData,
+      ...agentRef.info.jsAttributes
     };
   }
   const sharedEE = ee.get(agentRef.agentIdentifier);

package/dist/types/features/utils/agent-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/agent-session.js"],"names":[],"mappings":"AAWA,sDAsCC"}
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/agent-session.js"],"names":[],"mappings":"AAWA,sDAuCC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.292.0",
+  "version": "1.292.1-rc.1",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",

package/src/features/utils/agent-session.js

@@ -25,7 +25,8 @@ export function setupAgentSession (agentRef) {
   // Retrieve & re-add all of the persisted setCustomAttribute|setUserId k-v from previous page load(s), if any was stored.
   const customSessionData = agentRef.runtime.session.state.custom
   if (customSessionData) {
-    agentRef.info.jsAttributes = { ...agentRef.info.jsAttributes, ...customSessionData }
+    /** stored attributes from previous page should not take precedence over attributes stored on this page via API before the page load */
+    agentRef.info.jsAttributes = { ...customSessionData, ...agentRef.info.jsAttributes }
   }
 
   const sharedEE = ee.get(agentRef.agentIdentifier)