@newrelic/browser-agent 1.310.0 → 1.310.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.310.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.310.0...v1.310.1) (2026-02-19)
+
+
+### Bug Fixes
+
+* Enhance LCP entry with fallback attribution values ([#1701](https://github.com/newrelic/newrelic-browser-agent/issues/1701)) ([a212776](https://github.com/newrelic/newrelic-browser-agent/commit/a21277667d7ff05642c9a01ea77a492ecb8c0522))
+
 ## [1.310.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.309.0...v1.310.0) (2026-02-17)
 
 

package/README.md

@@ -47,7 +47,7 @@ Before instrumenting your app using the NPM package, a Browser App should be con
 
 For best results, import and instantiate the `BrowserAgent` class as close to the top of the `head` element of your app's HTML output as possible. The specific location and method will vary based on your application's architecture or framework. See [Library Support](#library-support) for more information.
 
-Populate the `options` parameter using configuration values found in the the *Copy/Paste JavaScript* box in your browser app's *Application settings* page in New Relic.
+Populate the `options` parameter using configuration values found in the *Copy/Paste JavaScript* box in your browser app's *Application settings* page in New Relic.
 
 ```javascript
 import { BrowserAgent } from '@newrelic/browser-agent/loaders/browser-agent'

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.310.0";
+const VERSION = exports.VERSION = "1.310.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.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.310.0";
+const VERSION = exports.VERSION = "1.310.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/drain/drain.js

@@ -135,7 +135,7 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
 
 /**
  * Processes the specified event using all relevant handler functions associated with a particular feature, based on
- * whether the the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
+ * whether the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
  * time an event is originally created by instrumentation, as with calls to the `handle` method.)
  * @param {*} evt - A single event to be emitted to (processed by) eligible handler functions.
  * @param {*} groupHandlers - A set of handler functions associated with a particular feature's event-group.

package/dist/cjs/common/harvest/harvester.js

@@ -43,7 +43,7 @@ class Harvester {
       this.initializedAggregates.forEach(aggregateInst => this.triggerHarvestFor(aggregateInst, {
         isFinalHarvest: true
       }));
-      /* This callback should run in bubble phase, so that that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
+      /* This callback should run in bubble phase, so that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
     }, false);
   }
   startTimer(harvestInterval = this.agentRef.init.harvest.interval) {

package/dist/cjs/common/vitals/largest-contentful-paint.js

@@ -10,7 +10,7 @@ var _constants = require("./constants");
 var _runtime = require("../constants/runtime");
 var _cleanUrl = require("../url/clean-url");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -22,26 +22,23 @@ if (_runtime.isBrowserScope) {
   }) => {
     /* Largest Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
     if (_runtime.initiallyHidden || largestContentfulPaint.isValid) return;
-    let attrs;
+    let attrs = {
+      timeToFirstByte: attribution.timeToFirstByte,
+      resourceLoadDelay: attribution.resourceLoadDelay,
+      resourceLoadDuration: attribution.resourceLoadDuration,
+      resourceLoadTime: attribution.resourceLoadDuration,
+      // kept for NR backwards compatibility, deprecated in v3->v4
+      elementRenderDelay: attribution.elementRenderDelay
+    };
     const lcpEntry = attribution.lcpEntry;
     if (lcpEntry) {
-      attrs = {
-        size: lcpEntry.size,
-        eid: lcpEntry.id,
-        element: attribution.element,
-        timeToFirstByte: attribution.timeToFirstByte,
-        resourceLoadDelay: attribution.resourceLoadDelay,
-        resourceLoadDuration: attribution.resourceLoadDuration,
-        resourceLoadTime: attribution.resourceLoadDuration,
-        // kept for NR backwards compatibility, deprecated in v3->v4
-        elementRenderDelay: attribution.elementRenderDelay,
-        ...(attribution.navigationEntry && {
-          pageUrl: (0, _cleanUrl.cleanURL)(attribution.navigationEntry.name)
-        }) // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
-      };
-      if (attribution.url) attrs.elUrl = (0, _cleanUrl.cleanURL)(attribution.url);
+      attrs.size = lcpEntry.size;
+      attrs.eid = lcpEntry.id;
       if (lcpEntry.element?.tagName) attrs.elTag = lcpEntry.element.tagName;
     }
+    if (attribution.element) attrs.element = attribution.element;
+    if (attribution.navigationEntry) attrs.pageUrl = (0, _cleanUrl.cleanURL)(attribution.navigationEntry.name); // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
+    if (attribution.url) attrs.elUrl = (0, _cleanUrl.cleanURL)(attribution.url);
     largestContentfulPaint.update({
       value,
       attrs

package/dist/cjs/features/jserrors/aggregate/index.js

@@ -95,7 +95,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   /**
    *
    * @param {Error|UncaughtError} err The error instance to be processed
-   * @param {number} time the relative ms (to origin) timestamp of occurence
+   * @param {number} time the relative ms (to origin) timestamp of occurrence
    * @param {boolean=} internal if the error was "caught" and deemed "internal" before reporting to the jserrors feature
    * @param {object=} customAttributes  any custom attributes to be included in the error payload
    * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session

package/dist/cjs/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -37,13 +37,13 @@ class InitialPageLoadInteraction extends _interaction.Interaction {
   get navTiming() {
     if (!_navTiming.navTimingValues.length) return;
     /*
-    1. we initialize the seperator to ',' (seperates the nodeType id from the first value)
+    1. we initialize the separator to ',' (separates the nodeType id from the first value)
     2. we initialize the navTiming node to 'b' (the nodeType id)
-    3. if the value is present, we add the seperator followed by the value;
+    3. if the value is present, we add the separator followed by the value;
        otherwise:
-        - we add null seperator ('!') to the navTimingNode
-        - we set the seperator to an empty string since we already wrote it above
-      the reason for writing the null seperator instead of setting the seperator
+        - we add null separator ('!') to the navTimingNode
+        - we set the separator to an empty string since we already wrote it above
+      the reason for writing the null separator instead of setting the separator
       is to ensure we still write it if the null is the last navTiming value.
     */
     let seperator = ',';

package/dist/cjs/features/utils/feature-base.js

@@ -20,7 +20,7 @@ class FeatureBase {
     /** @type {string} */
     this.featureName = featureName;
     /**
-     * Blocked can be used to prevent aggregation and harvest after inititalization time of the feature.
+     * Blocked can be used to prevent aggregation and harvest after initialization time of the feature.
      * This can currently happen if RUM response setToken flag is 0, which is tied to ingest account entitlement info.
      * @type {boolean}
      */

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.310.0";
+export const VERSION = "1.310.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.310.0";
+export const VERSION = "1.310.1-rc.1";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/drain/drain.js

@@ -127,7 +127,7 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
 
 /**
  * Processes the specified event using all relevant handler functions associated with a particular feature, based on
- * whether the the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
+ * whether the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
  * time an event is originally created by instrumentation, as with calls to the `handle` method.)
  * @param {*} evt - A single event to be emitted to (processed by) eligible handler functions.
  * @param {*} groupHandlers - A set of handler functions associated with a particular feature's event-group.

package/dist/esm/common/harvest/harvester.js

@@ -35,7 +35,7 @@ export class Harvester {
       this.initializedAggregates.forEach(aggregateInst => this.triggerHarvestFor(aggregateInst, {
         isFinalHarvest: true
       }));
-      /* This callback should run in bubble phase, so that that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
+      /* This callback should run in bubble phase, so that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
     }, false);
   }
   startTimer(harvestInterval = this.agentRef.init.harvest.interval) {

package/dist/esm/common/vitals/largest-contentful-paint.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onLCP } from 'web-vitals/attribution';
@@ -15,26 +15,23 @@ if (isBrowserScope) {
   }) => {
     /* Largest Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
     if (initiallyHidden || largestContentfulPaint.isValid) return;
-    let attrs;
+    let attrs = {
+      timeToFirstByte: attribution.timeToFirstByte,
+      resourceLoadDelay: attribution.resourceLoadDelay,
+      resourceLoadDuration: attribution.resourceLoadDuration,
+      resourceLoadTime: attribution.resourceLoadDuration,
+      // kept for NR backwards compatibility, deprecated in v3->v4
+      elementRenderDelay: attribution.elementRenderDelay
+    };
     const lcpEntry = attribution.lcpEntry;
     if (lcpEntry) {
-      attrs = {
-        size: lcpEntry.size,
-        eid: lcpEntry.id,
-        element: attribution.element,
-        timeToFirstByte: attribution.timeToFirstByte,
-        resourceLoadDelay: attribution.resourceLoadDelay,
-        resourceLoadDuration: attribution.resourceLoadDuration,
-        resourceLoadTime: attribution.resourceLoadDuration,
-        // kept for NR backwards compatibility, deprecated in v3->v4
-        elementRenderDelay: attribution.elementRenderDelay,
-        ...(attribution.navigationEntry && {
-          pageUrl: cleanURL(attribution.navigationEntry.name)
-        }) // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
-      };
-      if (attribution.url) attrs.elUrl = cleanURL(attribution.url);
+      attrs.size = lcpEntry.size;
+      attrs.eid = lcpEntry.id;
       if (lcpEntry.element?.tagName) attrs.elTag = lcpEntry.element.tagName;
     }
+    if (attribution.element) attrs.element = attribution.element;
+    if (attribution.navigationEntry) attrs.pageUrl = cleanURL(attribution.navigationEntry.name); // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
+    if (attribution.url) attrs.elUrl = cleanURL(attribution.url);
     largestContentfulPaint.update({
       value,
       attrs

package/dist/esm/features/jserrors/aggregate/index.js

@@ -90,7 +90,7 @@ export class Aggregate extends AggregateBase {
   /**
    *
    * @param {Error|UncaughtError} err The error instance to be processed
-   * @param {number} time the relative ms (to origin) timestamp of occurence
+   * @param {number} time the relative ms (to origin) timestamp of occurrence
    * @param {boolean=} internal if the error was "caught" and deemed "internal" before reporting to the jserrors feature
    * @param {object=} customAttributes  any custom attributes to be included in the error payload
    * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session

package/dist/esm/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -30,13 +30,13 @@ export class InitialPageLoadInteraction extends Interaction {
   get navTiming() {
     if (!navTimingValues.length) return;
     /*
-    1. we initialize the seperator to ',' (seperates the nodeType id from the first value)
+    1. we initialize the separator to ',' (separates the nodeType id from the first value)
     2. we initialize the navTiming node to 'b' (the nodeType id)
-    3. if the value is present, we add the seperator followed by the value;
+    3. if the value is present, we add the separator followed by the value;
        otherwise:
-        - we add null seperator ('!') to the navTimingNode
-        - we set the seperator to an empty string since we already wrote it above
-      the reason for writing the null seperator instead of setting the seperator
+        - we add null separator ('!') to the navTimingNode
+        - we set the separator to an empty string since we already wrote it above
+      the reason for writing the null separator instead of setting the separator
       is to ensure we still write it if the null is the last navTiming value.
     */
     let seperator = ',';

package/dist/esm/features/utils/feature-base.js

@@ -13,7 +13,7 @@ export class FeatureBase {
     /** @type {string} */
     this.featureName = featureName;
     /**
-     * Blocked can be used to prevent aggregation and harvest after inititalization time of the feature.
+     * Blocked can be used to prevent aggregation and harvest after initialization time of the feature.
      * This can currently happen if RUM response setToken flag is 0, which is tied to ingest account entitlement info.
      * @type {boolean}
      */

package/dist/types/features/jserrors/aggregate/index.d.ts

@@ -24,7 +24,7 @@ export class Aggregate extends AggregateBase {
     /**
      *
      * @param {Error|UncaughtError} err The error instance to be processed
-     * @param {number} time the relative ms (to origin) timestamp of occurence
+     * @param {number} time the relative ms (to origin) timestamp of occurrence
      * @param {boolean=} internal if the error was "caught" and deemed "internal" before reporting to the jserrors feature
      * @param {object=} customAttributes  any custom attributes to be included in the error payload
      * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session

package/dist/types/features/utils/feature-base.d.ts

@@ -7,7 +7,7 @@ export class FeatureBase {
     /** @type {string} */
     featureName: string;
     /**
-     * Blocked can be used to prevent aggregation and harvest after inititalization time of the feature.
+     * Blocked can be used to prevent aggregation and harvest after initialization time of the feature.
      * This can currently happen if RUM response setToken flag is 0, which is tied to ingest account entitlement info.
      * @type {boolean}
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.310.0",
+  "version": "1.310.1-rc.1",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",
@@ -284,4 +284,4 @@
     "README.md",
     "CHANGELOG.md"
   ]
-}
+}

package/src/common/drain/drain.js

@@ -128,7 +128,7 @@ function drainGroup (agentIdentifier, group, activateGroup = true) {
 
 /**
  * Processes the specified event using all relevant handler functions associated with a particular feature, based on
- * whether the the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
+ * whether the handler is meant to apply to events of this type. (Event type is a descriptive string set at the
  * time an event is originally created by instrumentation, as with calls to the `handle` method.)
  * @param {*} evt - A single event to be emitted to (processed by) eligible handler functions.
  * @param {*} groupHandlers - A set of handler functions associated with a particular feature's event-group.

package/src/common/harvest/harvester.js

@@ -35,7 +35,7 @@ export class Harvester {
         if (typeof aggregateInst.harvestOpts.beforeUnload === 'function') aggregateInst.harvestOpts.beforeUnload()
       })
       this.initializedAggregates.forEach(aggregateInst => this.triggerHarvestFor(aggregateInst, { isFinalHarvest: true }))
-      /* This callback should run in bubble phase, so that that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
+      /* This callback should run in bubble phase, so that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
     }, false)
   }
 

package/src/common/vitals/largest-contentful-paint.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onLCP } from 'web-vitals/attribution'
@@ -15,23 +15,22 @@ if (isBrowserScope) {
   /* Largest Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
     if (initiallyHidden || largestContentfulPaint.isValid) return
 
-    let attrs
+    let attrs = {
+      timeToFirstByte: attribution.timeToFirstByte,
+      resourceLoadDelay: attribution.resourceLoadDelay,
+      resourceLoadDuration: attribution.resourceLoadDuration,
+      resourceLoadTime: attribution.resourceLoadDuration, // kept for NR backwards compatibility, deprecated in v3->v4
+      elementRenderDelay: attribution.elementRenderDelay
+    }
     const lcpEntry = attribution.lcpEntry
     if (lcpEntry) {
-      attrs = {
-        size: lcpEntry.size,
-        eid: lcpEntry.id,
-        element: attribution.element,
-        timeToFirstByte: attribution.timeToFirstByte,
-        resourceLoadDelay: attribution.resourceLoadDelay,
-        resourceLoadDuration: attribution.resourceLoadDuration,
-        resourceLoadTime: attribution.resourceLoadDuration, // kept for NR backwards compatibility, deprecated in v3->v4
-        elementRenderDelay: attribution.elementRenderDelay,
-        ...(attribution.navigationEntry && { pageUrl: cleanURL(attribution.navigationEntry.name) }) // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
-      }
-      if (attribution.url) attrs.elUrl = cleanURL(attribution.url)
+      attrs.size = lcpEntry.size
+      attrs.eid = lcpEntry.id
       if (lcpEntry.element?.tagName) attrs.elTag = lcpEntry.element.tagName
     }
+    if (attribution.element) attrs.element = attribution.element
+    if (attribution.navigationEntry) attrs.pageUrl = cleanURL(attribution.navigationEntry.name) // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
+    if (attribution.url) attrs.elUrl = cleanURL(attribution.url)
 
     largestContentfulPaint.update({ value, attrs })
   })

package/src/features/jserrors/aggregate/index.js

@@ -99,7 +99,7 @@ export class Aggregate extends AggregateBase {
   /**
    *
    * @param {Error|UncaughtError} err The error instance to be processed
-   * @param {number} time the relative ms (to origin) timestamp of occurence
+   * @param {number} time the relative ms (to origin) timestamp of occurrence
    * @param {boolean=} internal if the error was "caught" and deemed "internal" before reporting to the jserrors feature
    * @param {object=} customAttributes  any custom attributes to be included in the error payload
    * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session

package/src/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -28,13 +28,13 @@ export class InitialPageLoadInteraction extends Interaction {
   get navTiming () {
     if (!navTimingValues.length) return
     /*
-    1. we initialize the seperator to ',' (seperates the nodeType id from the first value)
+    1. we initialize the separator to ',' (separates the nodeType id from the first value)
     2. we initialize the navTiming node to 'b' (the nodeType id)
-    3. if the value is present, we add the seperator followed by the value;
+    3. if the value is present, we add the separator followed by the value;
        otherwise:
-        - we add null seperator ('!') to the navTimingNode
-        - we set the seperator to an empty string since we already wrote it above
-      the reason for writing the null seperator instead of setting the seperator
+        - we add null separator ('!') to the navTimingNode
+        - we set the separator to an empty string since we already wrote it above
+      the reason for writing the null separator instead of setting the separator
       is to ensure we still write it if the null is the last navTiming value.
     */
     let seperator = ','

package/src/features/utils/feature-base.js

@@ -14,7 +14,7 @@ export class FeatureBase {
     /** @type {string} */
     this.featureName = featureName
     /**
-     * Blocked can be used to prevent aggregation and harvest after inititalization time of the feature.
+     * Blocked can be used to prevent aggregation and harvest after initialization time of the feature.
      * This can currently happen if RUM response setToken flag is 0, which is tied to ingest account entitlement info.
      * @type {boolean}
      */