interação (API SPA)

Sintaxe

newrelic.interaction([JSON object $options])

Retorna um novo objeto de identificador que está vinculado à interação SPA atual ou uma nova interação, caso não exista uma.

Requisitos

• Agente browser Pro+SPA (v963 ou superior)

• O parâmetro $options requer v1.285.0+

• Se estiver usando o npm para instalar o agente browser, você deverá ativar o recurso spa ao instanciar a classe BrowserAgent . Na matriz features , adicione o seguinte:

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

  Copiar

  Para obter mais informações, consulte a documentação de instalação do browser npm.

Descrição

A chamada de monitoramento SPA interaction() retorna um novo identificador que está vinculado à interação atual.

• New interaction: Se esta função for chamada e nenhuma interação estiver aberta ou em andamento, uma nova interação personalizada será criada.

  • Uma interação personalizada ainda seguirá a heurística padrão e fechará automaticamente na próxima navegação suave completa, a menos que waitForEnd seja especificado.

• New object: Se esta função for chamada enquanto uma interação estiver em andamento, um novo identificador referenciando a interação atual será criado.

  • Vários identificadores podem apontar para a mesma interação. Cada chamada .interaction cria um novo identificador.
  • O identificador apontará para a interação aberta, independentemente de ter começado a partir de um evento do usuário, como um click ou de uma chamada .interaction acionada pela API anterior.
  • Esta função não pode substituir seu próprio efeito ou o de um evento do usuário. Ou seja, ele não pode substituir nenhuma interação aberta existente por uma nova interação orientada por API.

Parâmetro

Valores de retorno

Este método retorna um objeto JS nativo que aponta para um eventoBrowserInteraction potencial. Cada vez que esse método é chamado para o mesmo BrowserInteraction enquanto ele ainda não terminou, um novo objeto é criado, mas ele ainda faz referência à mesma interação.

Exemplos

Os métodos da API SPA devem ser usados em newrelic.interaction(). Você pode atribuir o valor retornado ou o identificador a outra variável para uso posterior. Por exemplo:

let myInteraction = newrelic.interaction();
...
myInteraction.save();

Embora o identificador nomeado possa ser salvo e usado de fora de uma interação, observe que os métodos SPA não terão efeito após o término da interação.

A duração da interação também pode ser personalizada usando o seguinte método:

// Say an interaction is already open from a user click.
const userInteraction = newrelic.interaction({ waitForEnd: true }); // grabs the current interaction in-progress & keep it open
// URL changes & DOM is modified. Because of those condition being met, interaction will be saved but is kept open.
fetch('myurl.com/endpoint').then(() => userInteraction.end()) // associate this request to the interaction before completing this BrowserInteraction

const myCustomIxn = newrelic.interaction({ waitForEnd: true }) // create a new api-triggered interaction
// This interaction will be kept open indefinitely until `.end` is called, and no new interaction will start, custom or otherwise. AjaxRequest will continue to buffer under this interaction until it is closed.