@newrelic/browser-agent 1.235.0 → 1.237.0

package/src/loaders/agent.js

@@ -1,4 +1,5 @@
 // loader files
+import { AgentBase } from './agent-base'
 import { getEnabledFeatures } from './features/enabled-features'
 import { configure } from './configure/configure'
 import { getFeatureDependencyNames } from './features/featureDependencies'
@@ -12,13 +13,27 @@ import { generateRandomHexString } from '../common/ids/unique-id'
 import { getConfiguration, getInfo, getLoaderConfig, getRuntime } from '../common/config/config'
 import { warn } from '../common/util/console'
 import { stringify } from '../common/util/stringify'
+import { globalScope } from '../common/constants/runtime'
+
+/**
+ * @typedef {import('./api/interaction-types').InteractionInstance} InteractionInstance
+ */
 
 /**
  * A flexible class that may be used to compose an agent from a select subset of feature modules. In applications
  * sensitive to network load, this may result in smaller builds with slightly lower performance impact.
  */
-export class Agent {
+export class Agent extends AgentBase {
   constructor (options, agentIdentifier = generateRandomHexString(16)) {
+    super()
+
+    if (!globalScope) {
+      // We could not determine the runtime environment. Short-circuite the agent here
+      // to avoid possible exceptions later that may cause issues with customer's application.
+      warn('Failed to initial the agent. Could not determine the runtime environment.')
+      return
+    }
+
     this.agentIdentifier = agentIdentifier
     this.sharedAggregator = new Aggregator({ agentIdentifier: this.agentIdentifier })
     this.features = {}
@@ -76,4 +91,38 @@ export class Agent {
       return false
     }
   }
+
+  /* Below API methods are only available on a standard agent and not the micro agent */
+
+  /**
+   * Adds a JavaScript object with a custom name, start time, etc. to an in-progress session trace.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addtotrace/}
+   * @param {{name: string, start: number, end?: number, origin?: string, type?: string}} customAttributes Supply a JavaScript object with these required and optional name/value pairs:
+   *
+   * - Required name/value pairs: name, start
+   * - Optional name/value pairs: end, origin, type
+   *
+   * If you are sending the same event object to New Relic as a PageAction, omit the TYPE attribute. (type is a string to describe what type of event you are marking inside of a session trace.) If included, it will override the event type and cause the PageAction event to be sent incorrectly. Instead, use the name attribute for event information.
+   */
+  addToTrace (customAttributes) {
+    warn('Call to agent api addToTrace failed. The page action feature is not currently initialized.')
+  }
+
+  /**
+   * Gives SPA routes more accurate names than default names. Monitors specific routes rather than by default grouping.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcurrentroutename/}
+   * @param {string} name Current route name for the page.
+   */
+  setCurrentRouteName (name) {
+    warn('Call to agent api setCurrentRouteName failed. The spa feature is not currently initialized.')
+  }
+
+  /**
+   * Returns a new API object that is bound to the current SPA interaction.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
+   * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
+   */
+  interaction () {
+    warn('Call to agent api interaction failed. The spa feature is not currently initialized.')
+  }
 }

package/src/loaders/api/api.js

@@ -9,7 +9,7 @@ import { ee } from '../../common/event-emitter/contextual-ee'
 import { now } from '../../common/timing/now'
 import { drain, registerDrain } from '../../common/drain/drain'
 import { onWindowLoad } from '../../common/window/load'
-import { isBrowserScope } from '../../common/util/global-scope'
+import { isBrowserScope } from '../../common/constants/runtime'
 import { warn } from '../../common/util/console'
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants'
 import { gosCDN } from '../../common/window/nreum'
@@ -127,7 +127,7 @@ export function setAPI (agentIdentifier, forceDrain) {
           try {
             return cb.apply(this, arguments)
           } catch (err) {
-            tracerEE.emit('fn-err', [arguments, this, typeof err == 'string' ? new Error(err) : err], contextStore)
+            tracerEE.emit('fn-err', [arguments, this, err], contextStore)
             // the error came from outside the agent, so don't swallow
             throw err
           } finally {

package/src/loaders/api/apiAsync.js

@@ -4,8 +4,8 @@ import { ee } from '../../common/event-emitter/contextual-ee'
 import { handle } from '../../common/event-emitter/handle'
 import { registerHandler } from '../../common/event-emitter/register-handler'
 import { single } from '../../common/util/invoke'
-import { submitData } from '../../common/util/submit-data'
-import { isBrowserScope } from '../../common/util/global-scope'
+import * as submitData from '../../common/util/submit-data'
+import { isBrowserScope } from '../../common/constants/runtime'
 import { CUSTOM_METRIC_CHANNEL } from '../../features/metrics/constants'
 
 export function setAPI (agentIdentifier) {
@@ -78,7 +78,7 @@ export function setAPI (agentIdentifier) {
     url += 'fe=' + ~~fe_time + '&'
     url += 'c=' + cycle
 
-    submitData.img({ url })
+    submitData.xhr({ url })
   }
 
   function setErrorHandler (t, handler) {

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

@@ -0,0 +1,80 @@
+/**
+ * @typedef InteractionInstance
+ * @property {actionText} actionText
+ * @property {createTracer} createTracer
+ * @property {end} end
+ * @property {getContext} getContext
+ * @property {ignore} ignore
+ * @property {onEnd} onEnd
+ * @property {onEnd} save
+ * @property {setAttribute} setAttribute
+ * @property {setName} setName
+ */
+
+/**
+ * Sets the text value of the HTML element that was clicked to start a browser interaction.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/actiontext/}
+ * @callback actionText
+ * @param {string} value The text value of the HTML element that represents the action that started the interaction.
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Times sub-components of a SPA interaction separately, including wait time and JS execution time.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/createtracer/}
+ * @callback createTracer
+ * @param {string} name This will be used as the name of the tracer.
+ * @param {string} [callback] A callback that contains the synchronous work to run at the end of the async work. To execute this callback, call the wrapper function returned using createTracer().
+ * @returns {Function} Returns a method that wraps the original callback. When this method is invoked, it calls the original callback and ends the async timing.
+ */
+
+/**
+ * Ends the SPA interaction at the current time.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/end/}
+ * @callback end
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Stores values for the current SPA interaction asynchronously in browser.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/getcontext/}
+ * @callback getContext
+ * @param {(ctx: object) => void} callback This function is called when the interaction ends. It is called with one parameter, which is the interaction context.
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Change the values associated with a SPA interaction before the interaction is saved.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/onend/}
+ * @callback onEnd
+ * @param {(ctx: object) => void} callback This function is called when the interaction ends. It is called with one parameter, which is the interaction context.
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Ensures a SPA browser interaction will be saved when it ends.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/save/}
+ * @callback save
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Adds a custom SPA attribute only to the current interaction in browser.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setattribute/}
+ * @callback setAttribute
+ * @param {string} key Used as the attribute name on the BrowserInteraction event.
+ * @param {any} key Used as the attribute value on the BrowserInteraction event. This can be a string, number, boolean, or object. If it is an object, New Relic serializes it to a JSON string.
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/**
+ * Sets the name and trigger of a SPA's browser interaction that is not a route change or URL change.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setname/}
+ * @callback setName
+ * @param {string} name If null, the name will be set using the targetGroupedUrl attribute. If not null, this will set the browserInteractionName attribute in the BrowserInteraction event.
+ * @param {string} [trigger] If not null, this will set the TRIGGER attribute on the BrowserInteraction event.
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
+/* istanbul ignore next */
+export const unused = {}

package/src/loaders/configure/configure.js

@@ -1,8 +1,8 @@
 import { setAPI, setTopLevelCallers } from '../api/api'
 import { addToNREUM, gosCDN, gosNREUMInitializedAgents } from '../../common/window/nreum'
 import { setConfiguration, setInfo, setLoaderConfig, setRuntime } from '../../common/config/config'
-import { activateFeatures, activatedFeatures } from '../../common/util/feature-flags'
-import { isWorkerScope } from '../../common/util/global-scope'
+import { activatedFeatures } from '../../common/util/feature-flags'
+import { isWorkerScope } from '../../common/constants/runtime'
 
 export function configure (agentIdentifier, opts = {}, loaderType, forceDrain) {
   let { init, info, loader_config, runtime = { loaderType }, exposed = true } = opts
@@ -15,15 +15,16 @@ export function configure (agentIdentifier, opts = {}, loaderType, forceDrain) {
 
   setConfiguration(agentIdentifier, init || {})
   setLoaderConfig(agentIdentifier, loader_config || {})
-  setRuntime(agentIdentifier, runtime)
 
   info.jsAttributes ??= {}
   if (isWorkerScope) { // add a default attr to all worker payloads
     info.jsAttributes.isWorker = true
   }
-
   setInfo(agentIdentifier, info)
 
+  runtime.denyList = init.ajax?.block_internal ? (init.ajax.deny_list || []).concat(info.beacon, info.errorBeacon) : init.ajax?.deny_list
+  setRuntime(agentIdentifier, runtime)
+
   setTopLevelCallers()
   const api = setAPI(agentIdentifier, forceDrain)
   gosNREUMInitializedAgents(agentIdentifier, api, 'api')

package/src/loaders/micro-agent.js

@@ -1,4 +1,5 @@
 // loader files
+import { Instrument as PVE } from '../features/page_view_event/instrument'
 import { getEnabledFeatures } from './features/enabled-features'
 import { configure } from './configure/configure'
 // core files
@@ -8,28 +9,28 @@ import { generateRandomHexString } from '../common/ids/unique-id'
 import { getConfiguration, getInfo, getLoaderConfig, getRuntime } from '../common/config/config'
 import { FEATURE_NAMES } from './features/features'
 import { warn } from '../common/util/console'
+import { onWindowLoad } from '../common/window/load'
+import { AgentBase } from './agent-base'
 
 const nonAutoFeatures = [
   FEATURE_NAMES.jserrors,
-  FEATURE_NAMES.pageAction
-]
-
-const autoFeatures = [
+  FEATURE_NAMES.pageAction,
   FEATURE_NAMES.metrics
 ]
 
 /**
- * A minimal agent class designed to be loaded multiple times on the same page, each instance narrowly scoped to the
- * concerns of a particular component, as with the micro-frontend architectural pattern. This class does not
- * automatically instrument. Instead, each MicroAgent instance may be configured to lazy-load specific
- * instrumentations at runtime, and to report desired data, events, and errors programatically.
+ * A minimal agent class designed to only respond to manual user input. As such, this class does not
+ * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
+ * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
  */
-export class MicroAgent {
+export class MicroAgent extends AgentBase {
   /**
    * @param {Object} options - Specifies features and runtime configuration,
    * @param {string=} agentIdentifier - The optional unique ID of the agent.
    */
   constructor (options, agentIdentifier = generateRandomHexString(16)) {
+    super()
+
     this.agentIdentifier = agentIdentifier
     this.sharedAggregator = new Aggregator({ agentIdentifier: this.agentIdentifier })
     this.features = {}
@@ -51,28 +52,26 @@ export class MicroAgent {
   start () {
     try {
       const enabledFeatures = getEnabledFeatures(this.agentIdentifier)
-      autoFeatures.forEach(f => {
-        if (enabledFeatures[f]) {
-          // TODO - THIS does not work, the instrument switch in lazy loader increases the size of the worker build.  Needs to be revisited
-          import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
-            return lazyFeatureLoader(f, 'instrument')
-          }).then(({ Instrument }) => {
-            this.features[f] = new Instrument(this.agentIdentifier, this.sharedAggregator)
-          }).catch(err =>
-            warn('Something prevented the agent from being downloaded.'))
-        }
-      })
-      nonAutoFeatures.forEach(f => {
-        if (enabledFeatures[f]) {
-          // TODO - THIS does not work, the instrument switch in lazy loader increases the size of the worker build.  Needs to be revisited
-          // Parts of the lazy-loader were removed because webpack was transpiling them into the worker build, errantly inflating the build size.
-          import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
-            return lazyFeatureLoader(f, 'aggregate')
-          }).then(({ Aggregate }) => {
-            this.features[f] = new Aggregate(this.agentIdentifier, this.sharedAggregator)
-          }).catch(err =>
-            warn('Something prevented the agent from being downloaded.'))
-        }
+
+      try {
+        // a biproduct of doing this is that the "session manager" is automatically handled through importing this feature
+        this.features.page_view_event = new PVE(this.agentIdentifier, this.sharedAggregator)
+      } catch (err) {
+        warn('Something prevented the agent from instrumenting.', err)
+      }
+
+      onWindowLoad(() => {
+        // these features do not import an "instrument" file, meaning they are only hooked up to the API.
+        nonAutoFeatures.forEach(f => {
+          if (enabledFeatures[f]) {
+            import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
+              return lazyFeatureLoader(f, 'aggregate')
+            }).then(({ Aggregate }) => {
+              this.features[f] = new Aggregate(this.agentIdentifier, this.sharedAggregator)
+            }).catch(err =>
+              warn('Something prevented the agent from being downloaded.', err))
+          }
+        })
       })
       gosNREUMInitializedAgents(this.agentIdentifier, this.features, 'features')
       return this

package/dist/cjs/common/browser-version/firefox-version.js

@@ -1,17 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ffVersion = void 0;
-/*
- * Copyright 2020 New Relic Corporation. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/* eslint-disable no-useless-escape */
-
-var ffVersion = 0;
-exports.ffVersion = ffVersion;
-var match = navigator.userAgent.match(/Firefox[\/\s](\d+\.\d+)/);
-if (match) exports.ffVersion = ffVersion = +match[1];

package/dist/cjs/common/browser-version/ios-version.js

@@ -1,19 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isiOS = exports.iOS_below16 = void 0;
-const isiOS = /(iPad|iPhone|iPod)/g.test(navigator.userAgent);
-
-/* Feature detection to get our version(s). */
-
-// Shared Web Workers introduced in iOS 16.0+ and n/a in 15.6-
-exports.isiOS = isiOS;
-const iOS_below16 = isiOS && Boolean(typeof SharedWorker === 'undefined');
-/*
-  ^ It was discovered in Safari 14 (https://bugs.webkit.org/show_bug.cgi?id=225305) that the buffered flag in PerformanceObserver
-  did not work. This affects our onFCP metric in particular since web-vitals uses that flag to retrieve paint timing entries.
-  This was fixed in v16+.
-*/
-exports.iOS_below16 = iOS_below16;

package/dist/cjs/common/event-emitter/contextual-ee.test.js

@@ -1,282 +0,0 @@
-"use strict";
-
-var _faker = require("@faker-js/faker");
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-let mockNREUM;
-let runtime;
-beforeEach(() => {
-  mockNREUM = {};
-  runtime = {};
-  jest.doMock('../window/nreum', () => ({
-    __esModule: true,
-    gosNREUM: jest.fn(() => mockNREUM)
-  }));
-  jest.doMock('../config/config', () => ({
-    __esModule: true,
-    getRuntime: jest.fn(() => runtime)
-  }));
-});
-afterEach(() => {
-  jest.resetModules();
-  jest.resetAllMocks();
-});
-describe('global event-emitter', () => {
-  test('it returns the event-emitter defined on window.NREUM', async () => {
-    const mockEE = {};
-    mockNREUM.ee = mockEE;
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    expect(ee).toEqual(mockEE);
-  });
-  test('it sets the global event-emitter on window.NREUM', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    expect(ee).toEqual(mockNREUM.ee);
-  });
-});
-describe('scoping event-emitter', () => {
-  test('it creates a new child event-emitter', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const childName = _faker.faker.datatype.uuid();
-    const result = ee.get(childName);
-    expect(result).not.toEqual(mockNREUM.ee);
-    expect(result).toEqual(ee.get(childName)); // Should always return the same event-emitter
-    expect(result.debugId).toEqual(childName);
-  });
-  test('it creates a child event-emitter with an isolated backlog', async () => {
-    const childName = _faker.faker.random.alphaNumeric(16);
-    jest.doMock('../config/config', () => ({
-      __esModule: true,
-      getRuntime: jest.fn(id => {
-        if (id === childName) {
-          return {
-            isolatedBacklog: true
-          };
-        }
-        return runtime;
-      })
-    }));
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const result = ee.get(childName);
-    expect(ee.backlog).not.toBe(result.backlog);
-  });
-});
-describe('event-emitter context', () => {
-  test('it returns a new context', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const result = ee.context();
-    expect(result).toEqual({});
-  });
-  test('it returns the same context', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const result = ee.context();
-    expect(result).toEqual(ee.context(result));
-  });
-  test('it adds the context to the provided object', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const obj = {};
-    const result = ee.context(obj);
-    expect(result).toEqual(obj['nr@context']);
-  });
-});
-describe('event-emitter buffer', () => {
-  test('it should create a new buffer for the given group', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const eventType = _faker.faker.datatype.uuid();
-    const group = _faker.faker.datatype.uuid();
-    ee.buffer([eventType], group);
-    expect(ee.backlog).toEqual(expect.objectContaining({
-      [group]: []
-    }));
-    expect(ee.isBuffering(eventType)).toEqual(true);
-  });
-  test('it should default group to "feature"', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const eventType = _faker.faker.datatype.uuid();
-    ee.buffer([eventType]);
-    expect(ee.backlog).toEqual(expect.objectContaining({
-      feature: []
-    }));
-    expect(ee.isBuffering(eventType)).toEqual(true);
-  });
-  test('it should not create buffer if event-emitter is aborted', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const eventType = _faker.faker.datatype.uuid();
-    const group = _faker.faker.datatype.uuid();
-    ee.backlog = {
-      api: ['foo', 'bar', 'baz']
-    };
-    ee.abort();
-    ee.buffer([eventType], group);
-    expect(ee.backlog).toEqual({});
-    expect(ee.isBuffering(eventType)).toEqual(false);
-  });
-});
-describe('event-emitter abort', () => {
-  test('it aborts if there is an API backlog', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    ee.backlog = {
-      api: ['foo', 'bar', 'baz']
-    };
-    ee.abort();
-    expect(ee.aborted).toEqual(true);
-    expect(ee.backlog).toEqual({});
-  });
-  test('it aborts if there is a feature backlog', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    ee.backlog = {
-      feature: ['foo', 'bar', 'baz']
-    };
-    ee.abort();
-    expect(ee.aborted).toEqual(true);
-    expect(ee.backlog).toEqual({});
-  });
-});
-describe('event-emitter emit', () => {
-  test('should execute the listener', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const mockListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.on(eventType, mockListener);
-    ee.emit(eventType, eventArgs);
-    expect(mockListener).toHaveBeenCalledWith(eventArgs[0], eventArgs[1], eventArgs[2]);
-  });
-  test('should not execute the listener after removal', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const mockListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.on(eventType, mockListener);
-    ee.emit(eventType, eventArgs);
-    ee.removeEventListener(eventType, mockListener);
-    ee.emit(eventType, eventArgs);
-    expect(mockListener).toHaveBeenCalledTimes(1);
-  });
-  test('should return early if global event-emitter is aborted', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const mockListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.backlog = {
-      api: ['foo', 'bar', 'baz']
-    };
-    ee.abort();
-    ee.on(eventType, mockListener);
-    ee.emit(eventType, eventArgs);
-    expect(mockListener).toHaveBeenCalledTimes(0);
-  });
-  test('should still emit if global event-emitter is aborted but force flag is true', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const scopeEE = ee.get(_faker.faker.datatype.uuid());
-    const mockScopeListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.backlog = {
-      api: ['foo', 'bar', 'baz']
-    };
-    ee.abort();
-    scopeEE.on(eventType, mockScopeListener);
-    scopeEE.emit(eventType, eventArgs, {}, true);
-    expect(mockScopeListener).toHaveBeenCalledTimes(1);
-  });
-  test('should bubble the event if bubble flag is true', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const scopeEE = ee.get(_faker.faker.datatype.uuid());
-    const mockListener = jest.fn();
-    const mockScopeListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.on(eventType, mockListener);
-    scopeEE.on(eventType, mockScopeListener);
-    scopeEE.emit(eventType, eventArgs, {}, false, true);
-    expect(mockScopeListener).toHaveBeenCalledTimes(1);
-    expect(mockListener).toHaveBeenCalledTimes(1);
-  });
-  test('should not bubble the event if bubble flag is false', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const scopeEE = ee.get(_faker.faker.datatype.uuid());
-    const mockListener = jest.fn();
-    const mockScopeListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.on(eventType, mockListener);
-    scopeEE.on(eventType, mockScopeListener);
-    scopeEE.emit(eventType, eventArgs, {}, false, false);
-    expect(mockScopeListener).toHaveBeenCalledTimes(1);
-    expect(mockListener).not.toHaveBeenCalled();
-  });
-  test('should buffer the event on the scoped event-emitter', async () => {
-    const {
-      ee
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const scopeEE = ee.get(_faker.faker.datatype.uuid());
-    const mockListener = jest.fn();
-    const mockScopeListener = jest.fn();
-    const eventType = _faker.faker.datatype.uuid();
-    const eventArgs = ['a', 'b', 'c'];
-    ee.on(eventType, mockListener);
-    ee.buffer([eventType]);
-    scopeEE.on(eventType, mockScopeListener);
-    scopeEE.buffer([eventType]);
-    scopeEE.emit(eventType, eventArgs, {}, false, false);
-    expect(mockScopeListener).toHaveBeenCalledTimes(1);
-    expect(mockListener).not.toHaveBeenCalled();
-    expect(scopeEE.backlog.feature).toEqual(expect.arrayContaining([expect.arrayContaining([scopeEE, eventType, eventArgs, {}])]));
-    expect(ee.backlog.feature).toEqual(scopeEE.backlog.feature);
-  });
-});
-describe('getOrSetContext', () => {
-  test('it returns a new context', async () => {
-    const {
-      getOrSetContext
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const obj = {};
-    const result = getOrSetContext(obj);
-    expect(result).toEqual({});
-    expect(result).toEqual(obj['nr@context']);
-  });
-  test('it returns the same context', async () => {
-    const {
-      getOrSetContext
-    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
-    const obj = {};
-    const result = getOrSetContext(obj);
-    expect(getOrSetContext(obj)).toEqual(result);
-  });
-});