Avatar Diagnostic

AppNavi Avatar runs on different website where we sometime face the situation where native objects have been modified. Sometimes in a way that don’t conform to the standards.

For example, JSON.parse is one of the most used methods, if its overriden in a non-standard way, it would cause AppNavi to not function correctly.

Also some websites attach event listeners which work in such a way that may prevent proper AppNavi functions.

For example, if following event exists, It may prevent clicking inside the tooltip editor.

window.onselect = function (e) { e.preventDefault(); }

Therefore, looking at the above issues, its necessary for AppNavi to detect which Native objects have been modified and which events have been registered by the website so that when its time to debug the issues, developers are equiped with the information that they need.

What objects does it track?

Currently it checks for the following Native objects. These are the most used objects used in AppNavi.

• Date
• Array
• Object
• String
• Number
• Boolean
• Function
• BigInt
• Symbol
• JSON
• Map
• Set
• WeakMap
• WeakSet
• Promise
• RegExp
• Window
• Document

When its run?

Its run 2 seconds after AppNavi is initialized and only runs when globalDebug is on.

appnavi.runtime.setGlobalDebug(true)

After its run, user can see the output in the console.

Please note that diagnostic output is logged as debug and therefore only visible to user when All or Verbose mode is selected in the browser console.

Manual Call

Sometimes its desirable to not rely on the automatic diagnostic call, instead call it manually. In order to call it manually one can use following code.

appnavi.diagnostic.run()

To see more detailed diagnostics, call diagnostic with true parameter and it will output the method body as well.

appnavi.diagnostic.run(true)

Whats the impact?

In order to keep impact of diagnostic class minimum, we execute it 2 seconds after AppNavi is initialized. Also the automatic run is conditional as it only runs when global debug is on.

Therefore we can say that for normal users, there is no impact at all. For tech users who have global debug enabled, there is only minimum impact as it runs after 2 seconds.

Global Debug Mode

Display the enhanced logging to the console.

The global debug mode is primarily designed to provide core members with enhanced details on the console regarding AppNavi.

When "global debug mode" is activated, users will have access to this enhanced level of detail. This includes all functions necessary for debugging an application, such as API calls, z-index calculations, mining events, and more.

If this option is disabled, users will not be able to view additional events or details on the console.

To enable this option, users can follow these steps:

1. Navigate to the avatar icon.
2. Click on the "Open Settings" icon.
3. Access the "Settings" menu by clicking button.
4. Locate the "Global Debug Mode" option from General settings section.
5. Enable it to activate detailed logging on the console for both logged-in and logged-out users.

When to Use Global Debug Mode

Enable Global Debug Mode when you need to:

1. Investigate an AppNavi or Avatar issue.
2. Troubleshoot why an AppNavi feature is not working as expected.
3. Verify whether AppNavi events are being generated.
4. Inspect API requests and responses related to AppNavi.
5. Investigate element positioning or z-index-related issues.
6. Provide additional technical information to AppNavi Support or development teams.
7. Collect console information while reproducing an issue.

For normal users, Global Debug Mode should remain disabled unless troubleshooting instructions specifically require it.

Prerequisites

Before enabling Global Debug Mode:

1. You must have access to the AppNavi Avatar.
2. You should be able to open the browser's Developer Tools.
3. If you are troubleshooting a specific issue, reproduce the issue after enabling debug mode so the relevant diagnostic information is captured.
4. Use a supported browser and ensure the AppNavi Avatar is loaded correctly.

Tip: If AppNavi Support has asked you to collect diagnostic information, keep the issue description, affected application, URL, and steps to reproduce available while collecting the logs.

How to Enable Global Debug Mode

1. Open the AppNavi Avatar.
2. Click the Avatar icon.
3. Click Open Settings.
4. Open the Settings menu.
5. In the General settings section, locate Global Debug Mode.
6. Enable Global Debug Mode.
7. Open the browser's Developer Tools.
8. Select the Console tab.
9. Reproduce the issue or perform the action that you want to investigate.

Global Debug Mode enables detailed logging in the console for logged-in users.

Where Debug Information Appears

The additional information is displayed in the browser's Developer Tools → Console.

Depending on the feature being investigated, the console can contain information related to:

1. AppNavi API calls.
2. Mining events.
3. z-index calculations.
4. Other AppNavi diagnostic information.

The exact messages displayed can vary depending on the AppNavi features being used and the activity performed while debug mode is enabled.

Privacy and Security Considerations

Debug information may contain technical details about the current application session, requests, events, URLs, or other information generated while using AppNavi.

Therefore:

• Only enable Global Debug Mode when it is required for troubleshooting.
• Do not share console output publicly.

When to Disable Global Debug Mode

Disable Global Debug Mode when troubleshooting is complete.

To disable it:

1. Open the AppNavi Avatar.
2. Click the Avatar icon.
3. Open Settings.
4. Go to General settings.
5. Turn Global Debug Mode off.

After disabling it, AppNavi will no longer display the additional debug information provided by Global Debug Mode in the console.

Recommended : Keep Global Debug Mode disabled during normal usage and enable it only when troubleshooting or when requested by AppNavi Support team.