setCurrentRouteName (SPA API)

Syntax

newrelic.setCurrentRouteName(string $name)

Gives SPA routes more accurate names than default names. Monitors specific routes rather than by default grouping.

Requirements

• Browser Pro+SPA agent (v998 or higher)

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

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

  Copia

  For more information, see the npm browser installation documentation.

Description

This method names the current route. This can be useful to:

• Give routes more accurate names than they would have by default.
• Monitor a route that might otherwise be grouped with other routes by default.

Currently this method applies only to SPA BrowserInteraction events. Using this API creates two new custom attributes that track the previous route and the target route:

• previousRouteName
• targetRouteName

When using this API, the browserInteractionName attribute will take the targetRouteName value. If setName is used to set the browser interaction name, that will take precedence.

The setCurrentRouteName() API determines the name attributes for BrowserInteraction events, so this API must be called every time there is a route change. This will ensure that BrowserInteraction events have the correct attributes.

Parameters

Examples

router.onChange(function(route) {
  newrelic.setCurrentRouteName(route.name);
});