@newrelic/browser-agent 1.308.0 → 1.309.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.309.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.308.0...v1.309.0) (2026-02-03)
+
+
+### Features
+
+* Add WebDriver detection attribute to PageView & PageViewTiming ([#1679](https://github.com/newrelic/newrelic-browser-agent/issues/1679)) ([cd70213](https://github.com/newrelic/newrelic-browser-agent/commit/cd70213f6ef9898d1e40678fad850fbf03150570))
+* Improve MFE tag setting ([#1683](https://github.com/newrelic/newrelic-browser-agent/issues/1683)) ([73c0f4c](https://github.com/newrelic/newrelic-browser-agent/commit/73c0f4cd13b9ae894caefcc071b84a6d2d2ad7d6))
+* Warn when more than one agent is running ([#1686](https://github.com/newrelic/newrelic-browser-agent/issues/1686)) ([0deae4b](https://github.com/newrelic/newrelic-browser-agent/commit/0deae4b1743b3dd7674e0abd729fc9c9aba6582c))
+
+
+### Bug Fixes
+
+* allow child registrations from blocked parents ([#1677](https://github.com/newrelic/newrelic-browser-agent/issues/1677)) ([f3880e4](https://github.com/newrelic/newrelic-browser-agent/commit/f3880e41a638e68200572190ad0eb1af21f99ad4))
+* Micro agent duplicate handlers ([#1658](https://github.com/newrelic/newrelic-browser-agent/issues/1658)) ([203aa30](https://github.com/newrelic/newrelic-browser-agent/commit/203aa303a939d9de67e62276d457f6ba6378e931))
+
 ## [1.308.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.307.0...v1.308.0) (2026-01-08)
 
 

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.308.0";
+const VERSION = exports.VERSION = "1.309.0";
 
 /**
  * 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.308.0";
+const VERSION = exports.VERSION = "1.309.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -12,7 +12,7 @@ var _registerHandler = require("../event-emitter/register-handler");
 var _features = require("../../loaders/features/features");
 var _eventContext = require("../event-emitter/event-context");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -123,7 +123,7 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
           // registration *should* be an array of: [targetEE, eventHandler]
           // certain browser polyfills of .values and .entries pass the prototype methods into the callback,
           // which breaks this assumption and throws errors. So we make sure here that we only call .on() if its an actual NR EE
-          if (registration[0]?.on && registration[0]?.context() instanceof _eventContext.EventContext) registration[0].on(eventType, registration[1]);
+          if (registration[0]?.on && registration[0].context() instanceof _eventContext.EventContext && !registration[0].listeners(eventType).includes(registration[1])) registration[0].on(eventType, registration[1]);
         });
       });
     }

package/dist/cjs/common/session/session-entity.js

@@ -20,7 +20,7 @@ var _features = require("../../loaders/features/features");
 var _eventListenerOpts = require("../event-listener/event-listener-opts");
 var _constants3 = require("../../features/logging/constants");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/dist/cjs/common/util/webdriver-detection.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.webdriverDetected = void 0;
+var _runtime = require("../constants/runtime");
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Detects if the page is being controlled by WebDriver or automation tools derived from it.
+ * Checks for common indicators including:
+ * - navigator.webdriver property (standard WebDriver flag)
+ * - window.document.__webdriver_evaluate (WebDriver internal property)
+ * - window.document.__selenium_unwrapped (Selenium property)
+ * - window.document.__driver_evaluate (WebDriver internal property)
+ * - window.document.__webdriver_script_function (WebDriver internal property)
+ * - window.callPhantom (PhantomJS property)
+ * - window._phantom (PhantomJS property)
+ * - window.__nightmare (Nightmare.js property)
+ * - window.domAutomation (Chrome automation property)
+ * - window.domAutomationController (Chrome automation property)
+ *
+ * @type {boolean}
+ */
+const webdriverDetected = exports.webdriverDetected = (() => {
+  try {
+    // Standard WebDriver flag
+    if (typeof navigator !== 'undefined' && navigator.webdriver === true) {
+      return true;
+    }
+
+    // Check for various automation-related properties
+    if (_runtime.isBrowserScope) {
+      // WebDriver internal properties
+      if (document.__webdriver_evaluate || document.__selenium_unwrapped || document.__driver_evaluate || document.__webdriver_script_function) {
+        return true;
+      }
+
+      // PhantomJS detection
+      if (window.callPhantom || window._phantom) {
+        return true;
+      }
+
+      // Nightmare.js detection
+      if (window.__nightmare) {
+        return true;
+      }
+    }
+    return false;
+  } catch (err) {
+    // If any errors occur during detection, assume not automated
+    return false;
+  }
+})();

package/dist/cjs/common/window/nreum.js

@@ -16,9 +16,10 @@ exports.gosNREUMOriginals = gosNREUMOriginals;
 exports.setNREUMInitializedAgent = setNREUMInitializedAgent;
 var _runtime = require("../constants/runtime");
 var _now = require("../timing/now");
+var _console = require("../util/console");
 var _monkeyPatched = require("../util/monkey-patched");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -87,6 +88,11 @@ function setNREUMInitializedAgent(id, newAgentInstance) {
     date: new Date()
   };
   nr.initializedAgents[id] = newAgentInstance;
+
+  // Warn if using more than one agent, but only once per agent load
+  if (Object.keys(nr.initializedAgents).length === 2) {
+    (0, _console.warn)(69);
+  }
 }
 
 /**

package/dist/cjs/features/logging/constants.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.LOG_LEVELS = exports.LOGGING_MODE = exports.LOGGING_EVENT_EMITTER_CHANNEL = exports.FEATURE_NAME = void 0;
 var _features = require("../../loaders/features/features");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

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

@@ -22,9 +22,10 @@ var _traverse = require("../../../common/util/traverse");
 var _harvester = require("../../../common/harvest/harvester");
 var _features = require("../../../loaders/features/features");
 var _submitData = require("../../../common/util/submit-data");
+var _webdriverDetection = require("../../../common/util/webdriver-detection");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -90,12 +91,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
     };
     if (this.agentRef.runtime.session) queryParameters.fsh = Number(this.agentRef.runtime.session.isNew); // "first session harvest" aka RUM request or PageView event of a session
 
-    let body;
-    if (typeof customAttributes === 'object' && Object.keys(customAttributes).length > 0) {
-      body = (0, _traverse.applyFnToProps)({
-        ja: customAttributes
-      }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
-    }
+    let body = (0, _traverse.applyFnToProps)({
+      ja: {
+        ...customAttributes,
+        webdriverDetected: _webdriverDetection.webdriverDetected
+      }
+    }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
     if (_runtime.globalScope.performance) {
       if ((0, _runtime.supportsNavTimingL2)()) {
         // Navigation Timing level 2 API that replaced PerformanceTiming & PerformanceNavigation

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

@@ -20,8 +20,9 @@ var _constants2 = require("../../../common/vitals/constants");
 var _runtime = require("../../../common/constants/runtime");
 var _eventOrigin = require("../../../common/util/event-origin");
 var _loadTime = require("../../../common/vitals/load-time");
+var _webdriverDetection = require("../../../common/util/webdriver-detection");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -133,6 +134,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         timingAttributes[key] = val;
       }
     });
+    timingAttributes.webdriverDetected = _webdriverDetection.webdriverDetected;
   }
   preHarvestChecks() {
     this.checkForFirstInteraction();

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.Aggregate = void 0;
 var _handle = require("../../../common/event-emitter/handle");
 var _registerHandler = require("../../../common/event-emitter/register-handler");
+var _webdriverDetection = require("../../../common/util/webdriver-detection");
 var _loadTime = require("../../../common/vitals/load-time");
 var _features = require("../../../loaders/features/features");
 var _aggregateBase = require("../../utils/aggregate-base");
@@ -31,6 +32,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.initialPageLoadInteraction.onDone.push(() => {
       // this ensures the .end() method also works with iPL
       if (agentRef.runtime.session?.isNew) this.initialPageLoadInteraction.customAttributes.isFirstOfSession = true; // mark the hard page load as first of its session
+      this.initialPageLoadInteraction.customAttributes.webdriverDetected = _webdriverDetection.webdriverDetected;
       this.initialPageLoadInteraction.forceSave = true; // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction;
       this.events.add(ixn); // add the iPL ixn to the buffer for harvest

package/dist/cjs/loaders/api/register-api-types.js

@@ -26,6 +26,7 @@ exports.default = void 0;
  * @typedef {Object} RegisterAPIConstructor
  * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
+ * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
  * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
@@ -36,6 +37,7 @@ exports.default = void 0;
  * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @property {string} target.id - The ID for the registered entity.
  * @property {string} target.name - The name returned for the registered entity.
+ * @property {{[key: string]: any}} [target.tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [target.parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {boolean} [target.isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  */

package/dist/cjs/loaders/api/register.js

@@ -27,6 +27,8 @@ var _recordCustomEvent = require("./recordCustomEvent");
  * @typedef {import('./register-api-types').RegisterAPI} RegisterAPI
  */
 
+const PROTECTED_KEYS = ['name', 'id', 'type'];
+
 /**
  * @experimental
  * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
@@ -53,10 +55,14 @@ function register(agentRef, target, parent) {
   target.licenseKey ||= agentRef.info.licenseKey; // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false;
   target.parent = parent || {};
-  if (!Array.isArray(target.tags)) target.tags = [];
+  if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
   const attrs = {};
-  target.tags.forEach(tag => {
-    if (tag !== 'name' && tag !== 'id') attrs["source.".concat(tag)] = true;
+
+  // Process tags object and add to attrs, excluding protected keys
+  Object.entries(target.tags).forEach(([key, value]) => {
+    if (!PROTECTED_KEYS.includes(key)) {
+      attrs["source.".concat(key)] = value;
+    }
   });
   target.isolated ??= true;
 
@@ -167,12 +173,13 @@ function register(agentRef, target, parent) {
      * @returns
      */
   const report = (methodToCall, args, target) => {
-    if (isBlocked()) return;
+    /** Even if we are blocked, if registering we should still return a child register API so nested API calls do not throw errors */
+    if (isBlocked() && methodToCall !== register) return;
     /** set the timestamp before the async part of waiting for the rum response for better accuracy */
     const timestamp = (0, _now.now)();
     (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodToCall.name, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall.name !== 'register';
+      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall !== register;
       if (shouldDuplicate) {
         let duplicatedArgs = args;
         if (args[1] instanceof Object) {

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.308.0";
+export const VERSION = "1.309.0";
 
 /**
  * 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.308.0";
+export const VERSION = "1.309.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/drain/drain.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
  */
 
@@ -115,7 +115,7 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
           // registration *should* be an array of: [targetEE, eventHandler]
           // certain browser polyfills of .values and .entries pass the prototype methods into the callback,
           // which breaks this assumption and throws errors. So we make sure here that we only call .on() if its an actual NR EE
-          if (registration[0]?.on && registration[0]?.context() instanceof EventContext) registration[0].on(eventType, registration[1]);
+          if (registration[0]?.on && registration[0].context() instanceof EventContext && !registration[0].listeners(eventType).includes(registration[1])) registration[0].on(eventType, registration[1]);
         });
       });
     }

package/dist/esm/common/session/session-entity.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 { generateRandomHexString } from '../ids/unique-id';

package/dist/esm/common/util/webdriver-detection.js

@@ -0,0 +1,53 @@
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { isBrowserScope } from '../constants/runtime';
+
+/**
+ * Detects if the page is being controlled by WebDriver or automation tools derived from it.
+ * Checks for common indicators including:
+ * - navigator.webdriver property (standard WebDriver flag)
+ * - window.document.__webdriver_evaluate (WebDriver internal property)
+ * - window.document.__selenium_unwrapped (Selenium property)
+ * - window.document.__driver_evaluate (WebDriver internal property)
+ * - window.document.__webdriver_script_function (WebDriver internal property)
+ * - window.callPhantom (PhantomJS property)
+ * - window._phantom (PhantomJS property)
+ * - window.__nightmare (Nightmare.js property)
+ * - window.domAutomation (Chrome automation property)
+ * - window.domAutomationController (Chrome automation property)
+ *
+ * @type {boolean}
+ */
+export const webdriverDetected = (() => {
+  try {
+    // Standard WebDriver flag
+    if (typeof navigator !== 'undefined' && navigator.webdriver === true) {
+      return true;
+    }
+
+    // Check for various automation-related properties
+    if (isBrowserScope) {
+      // WebDriver internal properties
+      if (document.__webdriver_evaluate || document.__selenium_unwrapped || document.__driver_evaluate || document.__webdriver_script_function) {
+        return true;
+      }
+
+      // PhantomJS detection
+      if (window.callPhantom || window._phantom) {
+        return true;
+      }
+
+      // Nightmare.js detection
+      if (window.__nightmare) {
+        return true;
+      }
+    }
+    return false;
+  } catch (err) {
+    // If any errors occur during detection, assume not automated
+    return false;
+  }
+})();

package/dist/esm/common/window/nreum.js

@@ -1,9 +1,10 @@
 /**
- * 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 { globalScope } from '../constants/runtime';
 import { now } from '../timing/now';
+import { warn } from '../util/console';
 import { isNative } from '../util/monkey-patched';
 export const defaults = {
   beacon: 'bam.nr-data.net',
@@ -70,6 +71,11 @@ export function setNREUMInitializedAgent(id, newAgentInstance) {
     date: new Date()
   };
   nr.initializedAgents[id] = newAgentInstance;
+
+  // Warn if using more than one agent, but only once per agent load
+  if (Object.keys(nr.initializedAgents).length === 2) {
+    warn(69);
+  }
 }
 
 /**

package/dist/esm/features/logging/constants.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 { FEATURE_NAMES } from '../../loaders/features/features';

package/dist/esm/features/page_view_event/aggregate/index.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 { globalScope, isBrowserScope, originTime, supportsNavTimingL2 } from '../../../common/constants/runtime';
@@ -20,6 +20,7 @@ import { applyFnToProps } from '../../../common/util/traverse';
 import { send } from '../../../common/harvest/harvester';
 import { FEATURE_NAMES, FEATURE_TO_ENDPOINT } from '../../../loaders/features/features';
 import { getSubmitMethod } from '../../../common/util/submit-data';
+import { webdriverDetected } from '../../../common/util/webdriver-detection';
 export class Aggregate extends AggregateBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentRef) {
@@ -82,12 +83,12 @@ export class Aggregate extends AggregateBase {
     };
     if (this.agentRef.runtime.session) queryParameters.fsh = Number(this.agentRef.runtime.session.isNew); // "first session harvest" aka RUM request or PageView event of a session
 
-    let body;
-    if (typeof customAttributes === 'object' && Object.keys(customAttributes).length > 0) {
-      body = applyFnToProps({
-        ja: customAttributes
-      }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
-    }
+    let body = applyFnToProps({
+      ja: {
+        ...customAttributes,
+        webdriverDetected
+      }
+    }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
     if (globalScope.performance) {
       if (supportsNavTimingL2()) {
         // Navigation Timing level 2 API that replaced PerformanceTiming & PerformanceNavigation

package/dist/esm/features/page_view_timing/aggregate/index.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
  */
 
@@ -19,6 +19,7 @@ import { VITAL_NAMES } from '../../../common/vitals/constants';
 import { initiallyHidden } from '../../../common/constants/runtime';
 import { eventOrigin } from '../../../common/util/event-origin';
 import { loadTime } from '../../../common/vitals/load-time';
+import { webdriverDetected } from '../../../common/util/webdriver-detection';
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
   #handleVitalMetric = ({
@@ -127,6 +128,7 @@ export class Aggregate extends AggregateBase {
         timingAttributes[key] = val;
       }
     });
+    timingAttributes.webdriverDetected = webdriverDetected;
   }
   preHarvestChecks() {
     this.checkForFirstInteraction();

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

@@ -4,6 +4,7 @@
  */
 import { handle } from '../../../common/event-emitter/handle';
 import { registerHandler } from '../../../common/event-emitter/register-handler';
+import { webdriverDetected } from '../../../common/util/webdriver-detection';
 import { loadTime } from '../../../common/vitals/load-time';
 import { FEATURE_NAMES } from '../../../loaders/features/features';
 import { AggregateBase } from '../../utils/aggregate-base';
@@ -24,6 +25,7 @@ export class Aggregate extends AggregateBase {
     this.initialPageLoadInteraction.onDone.push(() => {
       // this ensures the .end() method also works with iPL
       if (agentRef.runtime.session?.isNew) this.initialPageLoadInteraction.customAttributes.isFirstOfSession = true; // mark the hard page load as first of its session
+      this.initialPageLoadInteraction.customAttributes.webdriverDetected = webdriverDetected;
       this.initialPageLoadInteraction.forceSave = true; // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction;
       this.events.add(ixn); // add the iPL ixn to the buffer for harvest

package/dist/esm/loaders/api/register-api-types.js

@@ -22,6 +22,7 @@
  * @typedef {Object} RegisterAPIConstructor
  * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
+ * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
  * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
@@ -33,6 +34,7 @@
  * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @property {string} target.id - The ID for the registered entity.
  * @property {string} target.name - The name returned for the registered entity.
+ * @property {{[key: string]: any}} [target.tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [target.parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {boolean} [target.isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  */

package/dist/esm/loaders/api/register.js

@@ -21,6 +21,8 @@ import { recordCustomEvent } from './recordCustomEvent';
  * @typedef {import('./register-api-types').RegisterAPI} RegisterAPI
  */
 
+const PROTECTED_KEYS = ['name', 'id', 'type'];
+
 /**
  * @experimental
  * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
@@ -47,10 +49,14 @@ function register(agentRef, target, parent) {
   target.licenseKey ||= agentRef.info.licenseKey; // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false;
   target.parent = parent || {};
-  if (!Array.isArray(target.tags)) target.tags = [];
+  if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
   const attrs = {};
-  target.tags.forEach(tag => {
-    if (tag !== 'name' && tag !== 'id') attrs["source.".concat(tag)] = true;
+
+  // Process tags object and add to attrs, excluding protected keys
+  Object.entries(target.tags).forEach(([key, value]) => {
+    if (!PROTECTED_KEYS.includes(key)) {
+      attrs["source.".concat(key)] = value;
+    }
   });
   target.isolated ??= true;
 
@@ -161,12 +167,13 @@ function register(agentRef, target, parent) {
      * @returns
      */
   const report = (methodToCall, args, target) => {
-    if (isBlocked()) return;
+    /** Even if we are blocked, if registering we should still return a child register API so nested API calls do not throw errors */
+    if (isBlocked() && methodToCall !== register) return;
     /** set the timestamp before the async part of waiting for the rum response for better accuracy */
     const timestamp = now();
     handle(SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodToCall.name, "/called")], undefined, FEATURE_NAMES.metrics, agentRef.ee);
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall.name !== 'register';
+      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall !== register;
       if (shouldDuplicate) {
         let duplicatedArgs = args;
         if (args[1] instanceof Object) {

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/index.js","../src/cdn/experimental.js","../src/cdn/lite.js","../src/cdn/pro.js","../src/cdn/spa.js","../src/common/aggregate/aggregator.js","../src/common/aggregate/event-aggregator.js","../src/common/config/configurable.js","../src/common/config/info.js","../src/common/config/init-types.js","../src/common/config/init.js","../src/common/config/loader-config.js","../src/common/config/runtime.js","../src/common/constants/agent-constants.js","../src/common/constants/env.cdn.js","../src/common/constants/env.js","../src/common/constants/env.npm.js","../src/common/constants/runtime.js","../src/common/constants/shared-channel.js","../src/common/deny-list/deny-list.js","../src/common/dispatch/global-event.js","../src/common/dom/iframe.js","../src/common/dom/query-selector.js","../src/common/dom/selector-path.js","../src/common/drain/drain.js","../src/common/event-emitter/contextual-ee.js","../src/common/event-emitter/event-context.js","../src/common/event-emitter/handle.js","../src/common/event-emitter/register-handler.js","../src/common/event-listener/event-listener-opts.js","../src/common/harvest/harvester.js","../src/common/harvest/types.js","../src/common/ids/bundle-id.js","../src/common/ids/id.js","../src/common/ids/unique-id.js","../src/common/serialize/bel-serializer.js","../src/common/session/constants.js","../src/common/session/session-entity.js","../src/common/storage/local-storage.js","../src/common/timer/interaction-timer.js","../src/common/timer/timer.js","../src/common/timing/nav-timing.js","../src/common/timing/now.js","../src/common/timing/time-keeper.js","../src/common/unload/eol.js","../src/common/url/canonicalize-url.js","../src/common/url/clean-url.js","../src/common/url/encode.js","../src/common/url/extract-url.js","../src/common/url/location.js","../src/common/url/parse-url.js","../src/common/url/protocol.js","../src/common/util/attribute-size.js","../src/common/util/console.js","../src/common/util/data-size.js","../src/common/util/event-origin.js","../src/common/util/feature-flags.js","../src/common/util/get-or-set.js","../src/common/util/invoke.js","../src/common/util/monkey-patched.js","../src/common/util/obfuscate.js","../src/common/util/stringify.js","../src/common/util/submit-data.js","../src/common/util/text.js","../src/common/util/traverse.js","../src/common/util/type-check.js","../src/common/util/v2.js","../src/common/vitals/constants.js","../src/common/vitals/cumulative-layout-shift.js","../src/common/vitals/first-contentful-paint.js","../src/common/vitals/first-paint.js","../src/common/vitals/interaction-to-next-paint.js","../src/common/vitals/largest-contentful-paint.js","../src/common/vitals/load-time.js","../src/common/vitals/time-to-first-byte.js","../src/common/vitals/vital-metric.js","../src/common/window/load.js","../src/common/window/nreum.js","../src/common/window/page-visibility.js","../src/common/wrap/wrap-events.js","../src/common/wrap/wrap-fetch.js","../src/common/wrap/wrap-function.js","../src/common/wrap/wrap-history.js","../src/common/wrap/wrap-jsonp.js","../src/common/wrap/wrap-logger.js","../src/common/wrap/wrap-mutation.js","../src/common/wrap/wrap-promise.js","../src/common/wrap/wrap-timer.js","../src/common/wrap/wrap-websocket.js","../src/common/wrap/wrap-xhr.js","../src/features/ajax/constants.js","../src/features/ajax/index.js","../src/features/ajax/aggregate/gql.js","../src/features/ajax/aggregate/index.js","../src/features/ajax/instrument/distributed-tracing.js","../src/features/ajax/instrument/index.js","../src/features/ajax/instrument/response-size.js","../src/features/generic_events/constants.js","../src/features/generic_events/index.js","../src/features/generic_events/aggregate/index.js","../src/features/generic_events/aggregate/user-actions/aggregated-user-action.js","../src/features/generic_events/aggregate/user-actions/user-actions-aggregator.js","../src/features/generic_events/instrument/index.js","../src/features/jserrors/constants.js","../src/features/jserrors/index.js","../src/features/jserrors/aggregate/canonical-function-name.js","../src/features/jserrors/aggregate/cause-string.js","../src/features/jserrors/aggregate/compute-stack-trace.js","../src/features/jserrors/aggregate/format-stack-trace.js","../src/features/jserrors/aggregate/index.js","../src/features/jserrors/aggregate/internal-errors.js","../src/features/jserrors/aggregate/string-hash-code.js","../src/features/jserrors/instrument/index.js","../src/features/jserrors/shared/cast-error.js","../src/features/jserrors/shared/uncaught-error.js","../src/features/logging/constants.js","../src/features/logging/index.js","../src/features/logging/aggregate/index.js","../src/features/logging/instrument/index.js","../src/features/logging/shared/log.js","../src/features/logging/shared/utils.js","../src/features/metrics/constants.js","../src/features/metrics/index.js","../src/features/metrics/aggregate/framework-detection.js","../src/features/metrics/aggregate/harvest-metadata.js","../src/features/metrics/aggregate/index.js","../src/features/metrics/instrument/index.js","../src/features/page_action/constants.js","../src/features/page_action/index.js","../src/features/page_action/instrument/index.js","../src/features/page_view_event/constants.js","../src/features/page_view_event/index.js","../src/features/page_view_event/aggregate/index.js","../src/features/page_view_event/aggregate/initialized-features.js","../src/features/page_view_event/instrument/index.js","../src/features/page_view_timing/constants.js","../src/features/page_view_timing/index.js","../src/features/page_view_timing/aggregate/index.js","../src/features/page_view_timing/instrument/index.js","../src/features/session_replay/constants.js","../src/features/session_replay/index.js","../src/features/session_replay/aggregate/index.js","../src/features/session_replay/instrument/index.js","../src/features/session_replay/shared/recorder-events.js","../src/features/session_replay/shared/recorder.js","../src/features/session_replay/shared/stylesheet-evaluator.js","../src/features/session_replay/shared/utils.js","../src/features/session_trace/constants.js","../src/features/session_trace/index.js","../src/features/session_trace/aggregate/index.js","../src/features/session_trace/aggregate/trace/node.js","../src/features/session_trace/aggregate/trace/storage.js","../src/features/session_trace/aggregate/trace/utils.js","../src/features/session_trace/instrument/index.js","../src/features/soft_navigations/constants.js","../src/features/soft_navigations/index.js","../src/features/soft_navigations/aggregate/ajax-node.js","../src/features/soft_navigations/aggregate/bel-node.js","../src/features/soft_navigations/aggregate/index.js","../src/features/soft_navigations/aggregate/initial-page-load-interaction.js","../src/features/soft_navigations/aggregate/interaction.js","../src/features/soft_navigations/instrument/index.js","../src/features/spa/constants.js","../src/features/spa/index.js","../src/features/spa/aggregate/index.js","../src/features/spa/aggregate/interaction-node.js","../src/features/spa/aggregate/interaction.js","../src/features/spa/aggregate/serializer.js","../src/features/spa/instrument/index.js","../src/features/utils/agent-session.js","../src/features/utils/aggregate-base.js","../src/features/utils/event-buffer.js","../src/features/utils/feature-base.js","../src/features/utils/feature-gates.js","../src/features/utils/instrument-base.js","../src/features/utils/nr1-debugger.js","../src/interfaces/registered-entity.js","../src/loaders/agent-base.js","../src/loaders/agent.js","../src/loaders/api-base.js","../src/loaders/browser-agent.js","../src/loaders/micro-agent-base.js","../src/loaders/micro-agent.js","../src/loaders/api/addPageAction.js","../src/loaders/api/addRelease.js","../src/loaders/api/addToTrace.js","../src/loaders/api/consent.js","../src/loaders/api/constants.js","../src/loaders/api/finished.js","../src/loaders/api/interaction-types.js","../src/loaders/api/interaction.js","../src/loaders/api/log.js","../src/loaders/api/measure.js","../src/loaders/api/noticeError.js","../src/loaders/api/pauseReplay.js","../src/loaders/api/recordCustomEvent.js","../src/loaders/api/recordReplay.js","../src/loaders/api/register-api-types.js","../src/loaders/api/register.js","../src/loaders/api/setApplicationVersion.js","../src/loaders/api/setCustomAttribute.js","../src/loaders/api/setErrorHandler.js","../src/loaders/api/setPageViewName.js","../src/loaders/api/setUserId.js","../src/loaders/api/sharedHandlers.js","../src/loaders/api/start.js","../src/loaders/api/topLevelCallers.js","../src/loaders/api/wrapLogger.js","../src/loaders/configure/configure.js","../src/loaders/configure/nonce.js","../src/loaders/configure/public-path.js","../src/loaders/features/enabled-features.js","../src/loaders/features/featureDependencies.js","../src/loaders/features/features.js"],"version":"5.9.3"}
+{"root":["../src/index.js","../src/cdn/experimental.js","../src/cdn/lite.js","../src/cdn/pro.js","../src/cdn/spa.js","../src/common/aggregate/aggregator.js","../src/common/aggregate/event-aggregator.js","../src/common/config/configurable.js","../src/common/config/info.js","../src/common/config/init-types.js","../src/common/config/init.js","../src/common/config/loader-config.js","../src/common/config/runtime.js","../src/common/constants/agent-constants.js","../src/common/constants/env.cdn.js","../src/common/constants/env.js","../src/common/constants/env.npm.js","../src/common/constants/runtime.js","../src/common/constants/shared-channel.js","../src/common/deny-list/deny-list.js","../src/common/dispatch/global-event.js","../src/common/dom/iframe.js","../src/common/dom/query-selector.js","../src/common/dom/selector-path.js","../src/common/drain/drain.js","../src/common/event-emitter/contextual-ee.js","../src/common/event-emitter/event-context.js","../src/common/event-emitter/handle.js","../src/common/event-emitter/register-handler.js","../src/common/event-listener/event-listener-opts.js","../src/common/harvest/harvester.js","../src/common/harvest/types.js","../src/common/ids/bundle-id.js","../src/common/ids/id.js","../src/common/ids/unique-id.js","../src/common/serialize/bel-serializer.js","../src/common/session/constants.js","../src/common/session/session-entity.js","../src/common/storage/local-storage.js","../src/common/timer/interaction-timer.js","../src/common/timer/timer.js","../src/common/timing/nav-timing.js","../src/common/timing/now.js","../src/common/timing/time-keeper.js","../src/common/unload/eol.js","../src/common/url/canonicalize-url.js","../src/common/url/clean-url.js","../src/common/url/encode.js","../src/common/url/extract-url.js","../src/common/url/location.js","../src/common/url/parse-url.js","../src/common/url/protocol.js","../src/common/util/attribute-size.js","../src/common/util/console.js","../src/common/util/data-size.js","../src/common/util/event-origin.js","../src/common/util/feature-flags.js","../src/common/util/get-or-set.js","../src/common/util/invoke.js","../src/common/util/monkey-patched.js","../src/common/util/obfuscate.js","../src/common/util/stringify.js","../src/common/util/submit-data.js","../src/common/util/text.js","../src/common/util/traverse.js","../src/common/util/type-check.js","../src/common/util/v2.js","../src/common/util/webdriver-detection.js","../src/common/vitals/constants.js","../src/common/vitals/cumulative-layout-shift.js","../src/common/vitals/first-contentful-paint.js","../src/common/vitals/first-paint.js","../src/common/vitals/interaction-to-next-paint.js","../src/common/vitals/largest-contentful-paint.js","../src/common/vitals/load-time.js","../src/common/vitals/time-to-first-byte.js","../src/common/vitals/vital-metric.js","../src/common/window/load.js","../src/common/window/nreum.js","../src/common/window/page-visibility.js","../src/common/wrap/wrap-events.js","../src/common/wrap/wrap-fetch.js","../src/common/wrap/wrap-function.js","../src/common/wrap/wrap-history.js","../src/common/wrap/wrap-jsonp.js","../src/common/wrap/wrap-logger.js","../src/common/wrap/wrap-mutation.js","../src/common/wrap/wrap-promise.js","../src/common/wrap/wrap-timer.js","../src/common/wrap/wrap-websocket.js","../src/common/wrap/wrap-xhr.js","../src/features/ajax/constants.js","../src/features/ajax/index.js","../src/features/ajax/aggregate/gql.js","../src/features/ajax/aggregate/index.js","../src/features/ajax/instrument/distributed-tracing.js","../src/features/ajax/instrument/index.js","../src/features/ajax/instrument/response-size.js","../src/features/generic_events/constants.js","../src/features/generic_events/index.js","../src/features/generic_events/aggregate/index.js","../src/features/generic_events/aggregate/user-actions/aggregated-user-action.js","../src/features/generic_events/aggregate/user-actions/user-actions-aggregator.js","../src/features/generic_events/instrument/index.js","../src/features/jserrors/constants.js","../src/features/jserrors/index.js","../src/features/jserrors/aggregate/canonical-function-name.js","../src/features/jserrors/aggregate/cause-string.js","../src/features/jserrors/aggregate/compute-stack-trace.js","../src/features/jserrors/aggregate/format-stack-trace.js","../src/features/jserrors/aggregate/index.js","../src/features/jserrors/aggregate/internal-errors.js","../src/features/jserrors/aggregate/string-hash-code.js","../src/features/jserrors/instrument/index.js","../src/features/jserrors/shared/cast-error.js","../src/features/jserrors/shared/uncaught-error.js","../src/features/logging/constants.js","../src/features/logging/index.js","../src/features/logging/aggregate/index.js","../src/features/logging/instrument/index.js","../src/features/logging/shared/log.js","../src/features/logging/shared/utils.js","../src/features/metrics/constants.js","../src/features/metrics/index.js","../src/features/metrics/aggregate/framework-detection.js","../src/features/metrics/aggregate/harvest-metadata.js","../src/features/metrics/aggregate/index.js","../src/features/metrics/instrument/index.js","../src/features/page_action/constants.js","../src/features/page_action/index.js","../src/features/page_action/instrument/index.js","../src/features/page_view_event/constants.js","../src/features/page_view_event/index.js","../src/features/page_view_event/aggregate/index.js","../src/features/page_view_event/aggregate/initialized-features.js","../src/features/page_view_event/instrument/index.js","../src/features/page_view_timing/constants.js","../src/features/page_view_timing/index.js","../src/features/page_view_timing/aggregate/index.js","../src/features/page_view_timing/instrument/index.js","../src/features/session_replay/constants.js","../src/features/session_replay/index.js","../src/features/session_replay/aggregate/index.js","../src/features/session_replay/instrument/index.js","../src/features/session_replay/shared/recorder-events.js","../src/features/session_replay/shared/recorder.js","../src/features/session_replay/shared/stylesheet-evaluator.js","../src/features/session_replay/shared/utils.js","../src/features/session_trace/constants.js","../src/features/session_trace/index.js","../src/features/session_trace/aggregate/index.js","../src/features/session_trace/aggregate/trace/node.js","../src/features/session_trace/aggregate/trace/storage.js","../src/features/session_trace/aggregate/trace/utils.js","../src/features/session_trace/instrument/index.js","../src/features/soft_navigations/constants.js","../src/features/soft_navigations/index.js","../src/features/soft_navigations/aggregate/ajax-node.js","../src/features/soft_navigations/aggregate/bel-node.js","../src/features/soft_navigations/aggregate/index.js","../src/features/soft_navigations/aggregate/initial-page-load-interaction.js","../src/features/soft_navigations/aggregate/interaction.js","../src/features/soft_navigations/instrument/index.js","../src/features/spa/constants.js","../src/features/spa/index.js","../src/features/spa/aggregate/index.js","../src/features/spa/aggregate/interaction-node.js","../src/features/spa/aggregate/interaction.js","../src/features/spa/aggregate/serializer.js","../src/features/spa/instrument/index.js","../src/features/utils/agent-session.js","../src/features/utils/aggregate-base.js","../src/features/utils/event-buffer.js","../src/features/utils/feature-base.js","../src/features/utils/feature-gates.js","../src/features/utils/instrument-base.js","../src/features/utils/nr1-debugger.js","../src/interfaces/registered-entity.js","../src/loaders/agent-base.js","../src/loaders/agent.js","../src/loaders/api-base.js","../src/loaders/browser-agent.js","../src/loaders/micro-agent-base.js","../src/loaders/micro-agent.js","../src/loaders/api/addPageAction.js","../src/loaders/api/addRelease.js","../src/loaders/api/addToTrace.js","../src/loaders/api/consent.js","../src/loaders/api/constants.js","../src/loaders/api/finished.js","../src/loaders/api/interaction-types.js","../src/loaders/api/interaction.js","../src/loaders/api/log.js","../src/loaders/api/measure.js","../src/loaders/api/noticeError.js","../src/loaders/api/pauseReplay.js","../src/loaders/api/recordCustomEvent.js","../src/loaders/api/recordReplay.js","../src/loaders/api/register-api-types.js","../src/loaders/api/register.js","../src/loaders/api/setApplicationVersion.js","../src/loaders/api/setCustomAttribute.js","../src/loaders/api/setErrorHandler.js","../src/loaders/api/setPageViewName.js","../src/loaders/api/setUserId.js","../src/loaders/api/sharedHandlers.js","../src/loaders/api/start.js","../src/loaders/api/topLevelCallers.js","../src/loaders/api/wrapLogger.js","../src/loaders/configure/configure.js","../src/loaders/configure/nonce.js","../src/loaders/configure/public-path.js","../src/loaders/features/enabled-features.js","../src/loaders/features/featureDependencies.js","../src/loaders/features/features.js"],"version":"5.9.3"}

package/dist/types/common/util/webdriver-detection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detects if the page is being controlled by WebDriver or automation tools derived from it.
+ * Checks for common indicators including:
+ * - navigator.webdriver property (standard WebDriver flag)
+ * - window.document.__webdriver_evaluate (WebDriver internal property)
+ * - window.document.__selenium_unwrapped (Selenium property)
+ * - window.document.__driver_evaluate (WebDriver internal property)
+ * - window.document.__webdriver_script_function (WebDriver internal property)
+ * - window.callPhantom (PhantomJS property)
+ * - window._phantom (PhantomJS property)
+ * - window.__nightmare (Nightmare.js property)
+ * - window.domAutomation (Chrome automation property)
+ * - window.domAutomationController (Chrome automation property)
+ *
+ * @type {boolean}
+ */
+export const webdriverDetected: boolean;
+//# sourceMappingURL=webdriver-detection.d.ts.map

package/dist/types/common/util/webdriver-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdriver-detection.d.ts","sourceRoot":"","sources":["../../../../src/common/util/webdriver-detection.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;GAeG;AACH,gCAFU,OAAO,CAmCb"}

package/dist/types/common/window/nreum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nreum.d.ts","sourceRoot":"","sources":["../../../../src/common/window/nreum.js"],"names":[],"mappings":"AAaA,gCAMC;AAED,oCAWC;AAED,4CASC;AAED,oCASC;AAED,yCAkBC;AAED,+EAQC;AAED;;;;GAIG;AACH,uDAGC;AAED,uDAGC;AAED,yCAGC;AAED,8BAMC"}
+{"version":3,"file":"nreum.d.ts","sourceRoot":"","sources":["../../../../src/common/window/nreum.js"],"names":[],"mappings":"AAcA,gCAMC;AAED,oCAWC;AAED,4CASC;AAED,oCASC;AAED,yCAkBC;AAED,+EAaC;AAED;;;;GAIG;AACH,uDAGC;AAED,uDAGC;AAED,yCAGC;AAED,8BAMC"}

package/dist/types/features/page_view_event/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/aggregate/index.js"],"names":[],"mappings":"AAuBA;IACE,2BAA2C;IAE3C,2BA4BC;IAzBC,iBAAoB;IAEpB,wBAAwB;IACxB,8BAA8B;IAC9B,8BAA8B;IAC9B,gBAAgB;IAsBlB;;;;OAIG;IACH,2BAFW,GAAC,QAoEX;IAbC;;;;;;;;;;;;;;mBAOC;IANC,iCAAyB;IAc7B,kCAEC;IAED;;;;;;aAiGC;CACF;8BA3N6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/aggregate/index.js"],"names":[],"mappings":"AAwBA;IACE,2BAA2C;IAE3C,2BA4BC;IAzBC,iBAAoB;IAEpB,wBAAwB;IACxB,8BAA8B;IAC9B,8BAA8B;IAC9B,gBAAgB;IAsBlB;;;;OAIG;IACH,2BAFW,GAAC,QAiEX;IAbC;;;;;;;;;;;;;;mBAOC;IANC,iCAAyB;IAc7B,kCAEC;IAED;;;;;;aAiGC;CACF;8BAzN6B,4BAA4B"}

package/dist/types/features/page_view_timing/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AAsBA;IACE,2BAAiC;IAMjC,2BA4BC;IA1BC,4BAA+B;IAC/B,0BAA6B;IA2B/B;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;;;MA6BC;IAED;;;OAGG;IACH,4BAFa,IAAI,CAahB;IAED,gDAUC;IAED,4BAGC;IAGD,qCAwBC;;CACF;8BAvJ6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AAuBA;IACE,2BAAiC;IAMjC,2BA4BC;IA1BC,4BAA+B;IAC/B,0BAA6B;IA2B/B;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;;;MA6BC;IAED;;;OAGG;IACH,4BAFa,IAAI,CAahB;IAED,gDAWC;IAED,4BAGC;IAGD,qCAwBC;;CACF;8BAzJ6B,4BAA4B"}

package/dist/types/features/soft_navigations/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/index.js"],"names":[],"mappings":"AAcA;IACE,2BAAiC;IACjC;;OA+DC;IA1DC,2BAAwC;IACxC,iBAA8B;IAE9B,uDAA0E;IAc1E,yBAA+B;IAC/B,0CAAiC;IACjC,yBAA4C;IAyC9C,qCAUC;IAED,0EAmBC;IAED,2BAiBC;IAED;;;;;;;OAOG;IACH,6BAHW,mBAAmB,OAsB7B;;CAiHF;8BAzQ6B,4BAA4B;2CAGf,iCAAiC;4BAChD,eAAe"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/index.js"],"names":[],"mappings":"AAeA;IACE,2BAAiC;IACjC;;OAgEC;IA3DC,2BAAwC;IACxC,iBAA8B;IAE9B,uDAA0E;IAe1E,yBAA+B;IAC/B,0CAAiC;IACjC,yBAA4C;IAyC9C,qCAUC;IAED,0EAmBC;IAED,2BAiBC;IAED;;;;;;;OAOG;IACH,6BAHW,mBAAmB,OAsB7B;;CAiHF;8BA1Q6B,4BAA4B;2CAGf,iCAAiC;4BAChD,eAAe"}

package/dist/types/loaders/api/register-api-types.d.ts

@@ -68,6 +68,12 @@ export type RegisterAPIConstructor = {
      * - The readable name for the registered entity. This will be assigned to any synthesized entities.
      */
     name: string;
+    /**
+     * - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
+     */
+    tags?: {
+        [key: string]: any;
+    } | undefined;
     /**
      * - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
      */
@@ -89,6 +95,9 @@ export type RegisterAPIMetadata = {
         licenseKey?: string | undefined;
         id: string;
         name: string;
+        tags?: {
+            [key: string]: any;
+        } | undefined;
         parentId?: string | undefined;
         isolated?: boolean | undefined;
     };

package/dist/types/loaders/api/register-api-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-api-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register-api-types.js"],"names":[],"mappings":";;;;;;mBAOc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;SAC3C,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;KAAC,KAAK,IAAI;;;;iBACxH,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI;;;;cAC1D,CAAC,MAAM,EAAE,sBAAsB,KAAK,WAAW;;;;gBAC/C,MAAM,IAAI;;;;uBACV,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;aAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAAC;;;;2BACrL,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;wBAC9B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI;;;;eAClF,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI;;;;cACtD,mBAAmB;;;;;;QAKnB,MAAM,GAAC,MAAM;;;;UACb,MAAM;;;;;;;;;;;;;;sBAON,MAAM;;;;YAEjB;QAA2B,UAAU;QACX,EAAE,EAAjB,MAAM;QACS,IAAI,EAAnB,MAAM;QACU,QAAQ;QACP,QAAQ;KACtC"}
+{"version":3,"file":"register-api-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register-api-types.js"],"names":[],"mappings":";;;;;;mBAOc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;SAC3C,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;KAAC,KAAK,IAAI;;;;iBACxH,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI;;;;cAC1D,CAAC,MAAM,EAAE,sBAAsB,KAAK,WAAW;;;;gBAC/C,MAAM,IAAI;;;;uBACV,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;aAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAAC;;;;2BACrL,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;wBAC9B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI;;;;eAClF,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI;;;;cACtD,mBAAmB;;;;;;QAKnB,MAAM,GAAC,MAAM;;;;UACb,MAAM;;;;;;;;;;;;;;;;;;;;sBAQN,MAAM;;;;YAEjB;QAA2B,UAAU;QACX,EAAE,EAAjB,MAAM;QACS,IAAI,EAAnB,MAAM;QACwB,IAAI;;;QAClB,QAAQ;QACP,QAAQ;KACtC"}

package/dist/types/loaders/api/register.d.ts

@@ -1,6 +1,3 @@
-/**
- * @typedef {import('./register-api-types').RegisterAPI} RegisterAPI
- */
 /**
  * @experimental
  * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.

package/dist/types/loaders/api/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAmBA;;GAEG;AAEH;;;;GAIG;AACH,mDAIC;0BAZY,OAAO,sBAAsB,EAAE,WAAW"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,mDAIC;0BAdY,OAAO,sBAAsB,EAAE,WAAW"}

package/package.json

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

package/src/common/drain/drain.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
  */
 
@@ -71,7 +71,7 @@ export function drain (agentIdentifier = '', featureName = 'feature', force = fa
 
 /** Checks all items in the registry to see if they have been "staged".  If ALL items are staged, it will drain all registry items (drainGroup).  It not, nothing will happen */
 function checkCanDrainAll (agentIdentifier) {
-// Only when the event-groups for all features are ready to drain (staged) do we execute the drain. This has the effect
+  // Only when the event-groups for all features are ready to drain (staged) do we execute the drain. This has the effect
   // that the last feature to call drain triggers drain for all features.
   const items = Array.from(registry[agentIdentifier])
   if (items.every(([key, values]) => values.staged)) {
@@ -115,7 +115,7 @@ function drainGroup (agentIdentifier, group, activateGroup = true) {
           // registration *should* be an array of: [targetEE, eventHandler]
           // certain browser polyfills of .values and .entries pass the prototype methods into the callback,
           // which breaks this assumption and throws errors. So we make sure here that we only call .on() if its an actual NR EE
-          if (registration[0]?.on && registration[0]?.context() instanceof EventContext) registration[0].on(eventType, registration[1])
+          if (registration[0]?.on && registration[0].context() instanceof EventContext && !registration[0].listeners(eventType).includes(registration[1])) registration[0].on(eventType, registration[1])
         })
       })
     }

package/src/common/session/session-entity.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 { generateRandomHexString } from '../ids/unique-id'

package/src/common/util/webdriver-detection.js

@@ -0,0 +1,57 @@
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { isBrowserScope } from '../constants/runtime'
+
+/**
+ * Detects if the page is being controlled by WebDriver or automation tools derived from it.
+ * Checks for common indicators including:
+ * - navigator.webdriver property (standard WebDriver flag)
+ * - window.document.__webdriver_evaluate (WebDriver internal property)
+ * - window.document.__selenium_unwrapped (Selenium property)
+ * - window.document.__driver_evaluate (WebDriver internal property)
+ * - window.document.__webdriver_script_function (WebDriver internal property)
+ * - window.callPhantom (PhantomJS property)
+ * - window._phantom (PhantomJS property)
+ * - window.__nightmare (Nightmare.js property)
+ * - window.domAutomation (Chrome automation property)
+ * - window.domAutomationController (Chrome automation property)
+ *
+ * @type {boolean}
+ */
+export const webdriverDetected = (() => {
+  try {
+    // Standard WebDriver flag
+    if (typeof navigator !== 'undefined' && navigator.webdriver === true) {
+      return true
+    }
+
+    // Check for various automation-related properties
+    if (isBrowserScope) {
+      // WebDriver internal properties
+      if (document.__webdriver_evaluate ||
+          document.__selenium_unwrapped ||
+          document.__driver_evaluate ||
+          document.__webdriver_script_function) {
+        return true
+      }
+
+      // PhantomJS detection
+      if (window.callPhantom || window._phantom) {
+        return true
+      }
+
+      // Nightmare.js detection
+      if (window.__nightmare) {
+        return true
+      }
+    }
+
+    return false
+  } catch (err) {
+    // If any errors occur during detection, assume not automated
+    return false
+  }
+})()

package/src/common/window/nreum.js

@@ -1,9 +1,10 @@
 /**
- * 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 { globalScope } from '../constants/runtime'
 import { now } from '../timing/now'
+import { warn } from '../util/console'
 import { isNative } from '../util/monkey-patched'
 
 export const defaults = {
@@ -82,6 +83,11 @@ export function setNREUMInitializedAgent (id, newAgentInstance) {
     date: new Date()
   }
   nr.initializedAgents[id] = newAgentInstance
+
+  // Warn if using more than one agent, but only once per agent load
+  if (Object.keys(nr.initializedAgents).length === 2) {
+    warn(69)
+  }
 }
 
 /**

package/src/features/logging/constants.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 { FEATURE_NAMES } from '../../loaders/features/features'

package/src/features/page_view_event/aggregate/index.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 { globalScope, isBrowserScope, originTime, supportsNavTimingL2 } from '../../../common/constants/runtime'
@@ -20,6 +20,7 @@ import { applyFnToProps } from '../../../common/util/traverse'
 import { send } from '../../../common/harvest/harvester'
 import { FEATURE_NAMES, FEATURE_TO_ENDPOINT } from '../../../loaders/features/features'
 import { getSubmitMethod } from '../../../common/util/submit-data'
+import { webdriverDetected } from '../../../common/util/webdriver-detection'
 
 export class Aggregate extends AggregateBase {
   static featureName = CONSTANTS.FEATURE_NAME
@@ -87,10 +88,7 @@ export class Aggregate extends AggregateBase {
 
     if (this.agentRef.runtime.session) queryParameters.fsh = Number(this.agentRef.runtime.session.isNew) // "first session harvest" aka RUM request or PageView event of a session
 
-    let body
-    if (typeof customAttributes === 'object' && Object.keys(customAttributes).length > 0) {
-      body = applyFnToProps({ ja: customAttributes }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string')
-    }
+    let body = applyFnToProps({ ja: { ...customAttributes, webdriverDetected } }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string')
 
     if (globalScope.performance) {
       if (supportsNavTimingL2()) { // Navigation Timing level 2 API that replaced PerformanceTiming & PerformanceNavigation

package/src/features/page_view_timing/aggregate/index.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
  */
 
@@ -19,6 +19,7 @@ import { VITAL_NAMES } from '../../../common/vitals/constants'
 import { initiallyHidden } from '../../../common/constants/runtime'
 import { eventOrigin } from '../../../common/util/event-origin'
 import { loadTime } from '../../../common/vitals/load-time'
+import { webdriverDetected } from '../../../common/util/webdriver-detection'
 
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME
@@ -126,6 +127,7 @@ export class Aggregate extends AggregateBase {
         timingAttributes[key] = val
       }
     })
+    timingAttributes.webdriverDetected = webdriverDetected
   }
 
   preHarvestChecks () {

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

@@ -4,6 +4,7 @@
  */
 import { handle } from '../../../common/event-emitter/handle'
 import { registerHandler } from '../../../common/event-emitter/register-handler'
+import { webdriverDetected } from '../../../common/util/webdriver-detection'
 import { loadTime } from '../../../common/vitals/load-time'
 import { FEATURE_NAMES } from '../../../loaders/features/features'
 import { AggregateBase } from '../../utils/aggregate-base'
@@ -25,6 +26,7 @@ export class Aggregate extends AggregateBase {
     this.initialPageLoadInteraction = new InitialPageLoadInteraction(agentRef)
     this.initialPageLoadInteraction.onDone.push(() => { // this ensures the .end() method also works with iPL
       if (agentRef.runtime.session?.isNew) this.initialPageLoadInteraction.customAttributes.isFirstOfSession = true // mark the hard page load as first of its session
+      this.initialPageLoadInteraction.customAttributes.webdriverDetected = webdriverDetected
       this.initialPageLoadInteraction.forceSave = true // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction
       this.events.add(ixn) // add the iPL ixn to the buffer for harvest

package/src/loaders/api/register-api-types.js

@@ -22,6 +22,7 @@
  * @typedef {Object} RegisterAPIConstructor
  * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
+ * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
  * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
@@ -33,6 +34,7 @@
  * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @property {string} target.id - The ID for the registered entity.
  * @property {string} target.name - The name returned for the registered entity.
+ * @property {{[key: string]: any}} [target.tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [target.parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {boolean} [target.isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  */

package/src/loaders/api/register.js

@@ -21,6 +21,8 @@ import { recordCustomEvent } from './recordCustomEvent'
  * @typedef {import('./register-api-types').RegisterAPI} RegisterAPI
  */
 
+const PROTECTED_KEYS = ['name', 'id', 'type']
+
 /**
  * @experimental
  * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
@@ -48,10 +50,17 @@ function register (agentRef, target, parent) {
   target.licenseKey ||= agentRef.info.licenseKey // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false
   target.parent = parent || {}
-  if (!Array.isArray(target.tags)) target.tags = []
+  if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {}
 
   const attrs = {}
-  target.tags.forEach(tag => { if (tag !== 'name' && tag !== 'id') attrs[`source.${tag}`] = true })
+
+  // Process tags object and add to attrs, excluding protected keys
+  Object.entries(target.tags).forEach(([key, value]) => {
+    if (!PROTECTED_KEYS.includes(key)) {
+      attrs[`source.${key}`] = value
+    }
+  })
+
   target.isolated ??= true
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
@@ -136,12 +145,13 @@ function register (agentRef, target, parent) {
      * @returns
      */
   const report = (methodToCall, args, target) => {
-    if (isBlocked()) return
+    /** Even if we are blocked, if registering we should still return a child register API so nested API calls do not throw errors */
+    if (isBlocked() && methodToCall !== register) return
     /** set the timestamp before the async part of waiting for the rum response for better accuracy */
     const timestamp = now()
     handle(SUPPORTABILITY_METRIC_CHANNEL, [`API/register/${methodToCall.name}/called`], undefined, FEATURE_NAMES.metrics, agentRef.ee)
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall.name !== 'register'
+      const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall !== register
       if (shouldDuplicate) {
         let duplicatedArgs = args
         if (args[1] instanceof Object) {