setName (API SPA)

Syntaxe

newrelic.interaction().setName(string $name[, string $trigger])

Définit le nom et le déclencheur de l'interaction du navigateur d'un SPA qui n'est pas un changement d'itinéraire ou un changement d'URL.

Exigences

• Agent navigateur Pro+SPA (v963 ou supérieur)

• Si vous utilisez npm pour installer l'agent du navigateur, vous devez activer la fonctionnalité spa lors de l'instanciation de la classe BrowserAgent . Dans l'éventail features , ajoutez ce qui suit :

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

  Copier

  Pour plus d'informations, consultez la documentation d'installation du navigateur npm.

Description

Cette méthode monitoring SPA définit le nom et le déclencheur d'une interaction avec le navigateur. Le nom sera exposé comme l'attribut browserInteractionName dans l'événement BrowserInteraction . Il sera également utilisé pour le regroupement dans l'UI.

Par défaut, browserInteractionName est nommé d'après une URL ou un itinéraire associé. Utilisez setName() lorsque vous souhaitez enregistrer une interaction qui n’est pas un changement d’itinéraire ou un changement d’URL.

La méthode setCurrentRouteName() nomme également l'itinéraire actuel. Lorsque vous utilisez les deux :

• setName() a la priorité pour nommer l'interaction.
• Les attributs previousRouteName et targetRouteName sont toujours définis avec des valeurs transmises à setCurrentRouteName().

L'utilisation conjointe de ces méthodes permet de nombreuses options de filtrage et de regroupement dans l'UI. Par exemple, vous pouvez :

• Filtrer jusqu'à l'interaction d'un certain type, tel que LikeButtonClick.
• Ensuite, regroupez par targetRouteName pour voir quels itinéraires ont le plus d'interaction LikeButtonClick .

Paramètres

Valeurs de retour

Cette méthode renvoie le même objet API créé par interaction().

Exemples

document.getElementById('subscribe').addEventListener('submit', () => {
  newrelic.interaction().setName('createSubscription');
  createSubscription();
});