finished

Syntax

newrelic.finished(time $time_stamp)

Records an additional time point as "finished" in a session trace, and sends the event to New Relic.

Requirements

  • Browser Pro, Pro+SPA, or Lite agent (v593 or higher)

  • If you're using npm to install the browser agent, you must enable the generic_events and/or session_trace feature when instantiating the BrowserAgent class. In the features array, add the following:

    import { GenericEvents } from '@newrelic/browser-agent/features/generic_events'
    import { SessionTrace } from '@newrelic/browser-agent/features/session_trace';
    const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
    GenericEvents
    SessionTrace
    ]
    }

    For more information, see the npm browser installation documentation.

Description

Records an additional time point when the page is finished according to your custom criteria, either before or after the page load event. This is useful, for example, for pages with many components that load asynchronously.

You can only call this method once per page load, and it does not change the other page load timing data recorded for the load. For an individual page load, this call:

  1. Adds a finished event to the current browser session trace, if one is in progress.
  2. Submits a PageAction event with the name finished to New Relic.

Parameters

Parameter

Description

$time_stamp

integer (UNIX time)

Optional. Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.

Examples

aboveTheFoldContent.on('ready', function() {
newrelic.finished();
});