définir le gestionnaire d'erreurs

Syntaxe

newrelic.setErrorHandler(function $callback)

Permet d'ignorer et de regrouper de manière sélective les erreurs connues que l'agent du navigateur capture.

Exigences

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

  • Pour la capacité de regroupement des erreurs, la version 1.230.0 ou supérieure est requise.

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

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

  Copier

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

Description

L'appel d'API newrelic.setErrorHandler() vous permet d'ignorer de manière sélective les erreurs connues capturées par l'agent du navigateur. Il faut une seule fonction de gestion des erreurs, qui sera appelée pour chaque erreur capturée par l'agent du navigateur. Si le gestionnaire renvoie true, New Relic n’enregistre pas l’erreur. Sinon, l'erreur sera traitée normalement.

De plus, les versions ultérieures de l'agent prennent en charge les empreintes ou le regroupement d'exceptions avec une étiquette personnalisée fournie. Pour ce faire, renvoyez un objet au lieu d'un booléen avec une propriété group définie sur la chaîne souhaitée. Il est important de savoir que fournir une chaîne vide, ou tout objet qui n'est pas conforme à cette spécification exacte, est traité de la même manière que le cas true , pour lequel l'erreur sera ignorée. Ce comportement est rétrocompatible avec les versions antérieures.

Paramètres

Exemples

Utiliser une fonction de gestion d'erreurs de base

Incluez l’objet d’erreur à l’intérieur de la fonction de rappel pour ignorer les erreurs spécifiques capturées par l’agent du navigateur.

newrelic.setErrorHandler(function(err) {
  if (shouldIgnoreError(err)) {
    return true;
  } else {
    return false;
  }
});

Erreurs d'empreintes digitales dans la fonction de gestionnaire

Attribuez des étiquettes personnalisées à des erreurs spécifiques pour les afficher dans l'UI Errors Inbox.

newrelic.setErrorHandler(function(err) {
  if (isReferenceError(err)) {
    return { group: 'My reference errors' }; // error is included and tagged under this label
  } else if (isSomeSpecificError(err)) {
    return { group: '' }; // error will be excluded!
    // return { Group: 'still excluded - prop name has capital G!' };
  } else {
    return false; // error is included without any label
  }
})