この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

setCurrentRouteName (SPA API)

構文

newrelic.setCurrentRouteName(string $name)

SPA ルートにデフォルトの名前よりも正確な名前をつける。デフォルトのグループ化ではなく、特定のルートを監視します。

要件

  • ブラウザ Pro+SPA エージェント (v998 以降)

  • npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときにspa機能を有効にする必要があります。features配列に以下を追加します。

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

    詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。

説明

このメソッドは、現在のルートに名前を付けます。これは次のような場合に便利です。

  • ルートにデフォルトよりも正確な名前をつける。
  • デフォルトでは他のルートとグループ化されている可能性のあるルートを監視します。

現在、このメソッドは SPA BrowserInteractionイベントにのみ適用されます。この API を使用すると、以前のルートとターゲット ルートを追跡する 2 つの新しいカスタム属性が作成されます。

  • previousRouteName
  • targetRouteName

この API を使用する場合、 browserInteractionName属性はtargetRouteName値を取ります。setNameを使用してブラウザー インタラクション名を設定すると、それが優先されます。

setCurrentRouteName() API はBrowserInteractionイベントの名前属性を決定するため、ルート変更がある場合はこの API をevery timeで呼び出す必要があります。 これにより、 BrowserInteractionイベントに正しい属性が設定されます。

ヒント

ルートではなくブラウザ インタラクションの名前を設定するsetName()と比較してください。

パラメーター

パラメータ

説明

$name

ストリング

必須項目です。ページの現在のルート名。

setCurrentRouteName()に渡されるルート名は任意の文字列にすることができますが、特定のリソースではなくルーティングpatternを表す必要があります。 たとえば、 /users/123ではなく/users/:id使用します。

nullの場合、ルート変更要件を終了し、デフォルトの命名戦略に戻ります。

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