SPA compatibility and requirements

In order to set up Single Page Application (SPA) monitoring for Browser monitoring, make sure your app meets these SPA monitoring requirements.

Browser agent version

SPA monitoring requires an SPA-specific version of the Browser snippet, available for Browser agent version 885 or higher.

Browser types

SPA monitoring requires the addEventListener Browser API and the Navigation Timing API. Both APIs are available in all modern browsers, including Google Chrome, Mozilla Firefox, Apple Safari, and Microsoft Internet Explorer (IE) versions 9 or higher.

Framework requirements

Because SPA instrumentation works by wrapping low-level browser APIs, it is framework-agnostic. SPA instrumentation is compatible with most SPA frameworks, such as Angular, Backbone, Ember, and React. It can also instrument requests made using JSONP.

Below are known compatibility issues:

  • If your application uses AngularJS and you want to use Browser's SPA monitoring capabilities, Zone.js versions 0.6.18-0.6.24 are not compatible with the SPA agent.
  • The html2pdf.js library is not compatible with the SPA agent.

Security when collecting hash fragments

New Relic collects and saves hash fragments from route change URLs. If you use hashes to pass private or sensitive data, that data may be visible to your New Relic account users. Follow Browser's guidelines for security with data collection and reporting.

For more help

Additional documentation resources include:

If you need more help, check out these support and learning resources: