• ログイン

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

setCurrentRouteName(ブラウザ SPA API)

構文

newrelic.setCurrentRouteName(string $name)

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

要件

エージェントのバージョン nr-998 以上。

説明

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

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

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

  • previousRouteName
  • ターゲットルート名(TargetRouteName)

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

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

ヒント

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

パラメータ

パラメーター

説明

$name

文字列

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

setCurrentRouteName() に渡されるルート名は、どんな文字列でもよいのですが、特定のリソースではなく、ルーティング パターン を表すものでなければなりません。例えば、 /users/:id ではなく、 /users/123 を使用してください。

null の場合は、ルート変更要求から抜け出し、デフォルトのネーミング戦略に戻ります。

router.onChange(function (route) {
newrelic.setCurrentRouteName(route.name)
})
Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.