@microsoft/applicationinsights-core-js 2.7.2-nightly.2111-10 → 2.7.2-nightly.2111-12

package/dist/applicationinsights-core-js.api.json

@@ -4084,6 +4084,96 @@
           "parameters": [],
           "name": "getCrypto"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!getDebugExt:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getDebugExt(config: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IConfiguration",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "IDbgExtension",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "config",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "name": "getDebugExt"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!getDebugListener:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getDebugListener(config: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IConfiguration",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "INotificationListener",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!INotificationListener:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "config",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "name": "getDebugListener"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@microsoft/applicationinsights-core-js!getDocument:function(1)",
@@ -5826,6 +5916,32 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#disableDbgExt:member",
+              "docComment": "/**\n * [Optional] A flag for performance optimization to disable attempting to use the Chrome Debug Extension, if disabled and the extension is installed this will not send any notifications.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "disableDbgExt?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "disableDbgExt",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#disableInstrumentationKeyValidation:member",
@@ -7760,6 +7876,205 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IDbgExtension "
+            }
+          ],
+          "releaseTag": "Public",
+          "name": "IDbgExtension",
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#debugMsg:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugMsg?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(name: string, data: any) => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "debugMsg",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#diagLog:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "diagLog?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(name: string, data: any) => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "diagLog",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#disable:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "disable: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "disable",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#enable:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "enable: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "enable",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#isEnabled:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isEnabled: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "isEnabled",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#listener:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "listener: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "INotificationListener",
+                  "canonicalReference": "@microsoft/applicationinsights-core-js!INotificationListener:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "listener",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IDbgExtension#sendEvt:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "sendEvt?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(name: string, data: any) => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "sendEvt",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@microsoft/applicationinsights-core-js!IDiagnosticLogger:interface",

package/dist/applicationinsights-core-js.api.md

@@ -186,6 +186,12 @@ export function getCookie(logger: IDiagnosticLogger, name: string): string;
 // @public
 export function getCrypto(): Crypto | null;
 
+// @public (undocumented)
+export function getDebugExt(config: IConfiguration): IDbgExtension;
+
+// @public (undocumented)
+export function getDebugListener(config: IConfiguration): INotificationListener;
+
 // @public
 export function getDocument(): Document | null;
 
@@ -288,6 +294,7 @@ export interface IConfiguration {
     createPerfMgr?: (core: IAppInsightsCore, notificationManager: INotificationManager) => IPerfManager;
     diagnosticLogInterval?: number;
     disableCookiesUsage?: boolean;
+    disableDbgExt?: boolean;
     disableInstrumentationKeyValidation?: boolean;
     disablePageShowEvents?: string[];
     disablePageUnloadEvents?: string[];
@@ -377,6 +384,24 @@ export interface ICustomProperties {
     [key: string]: any;
 }
 
+// @public (undocumented)
+export interface IDbgExtension {
+    // (undocumented)
+    debugMsg?: (name: string, data: any) => void;
+    // (undocumented)
+    diagLog?: (name: string, data: any) => void;
+    // (undocumented)
+    disable: () => void;
+    // (undocumented)
+    enable: () => void;
+    // (undocumented)
+    isEnabled: () => boolean;
+    // (undocumented)
+    listener: INotificationListener;
+    // (undocumented)
+    sendEvt?: (name: string, data: any) => void;
+}
+
 // @public (undocumented)
 export interface IDiagnosticLogger {
     consoleLoggingLevel: () => number;

package/dist/applicationinsights-core-js.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 2.7.2-nightly.2111-10
+ * Microsoft Application Insights Core Javascript SDK, 2.7.2-nightly.2111-12
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -395,6 +395,10 @@ declare namespace ApplicationInsights {
      */
     function getCrypto(): Crypto | null;
 
+    function getDebugExt(config: IConfiguration): IDbgExtension;
+
+    function getDebugListener(config: IConfiguration): INotificationListener;
+
     /**
      * Returns the global document object if it is present otherwise null.
      * This helper is used to access the document object without causing an exception
@@ -733,6 +737,11 @@ declare namespace ApplicationInsights {
          * Page Show events include "pageshow" and "visibilitychange" (with 'visible' state)
          */
         disablePageShowEvents?: string[];
+        /**
+         * [Optional] A flag for performance optimization to disable attempting to use the Chrome Debug Extension, if disabled and the extension is installed
+         * this will not send any notifications.
+         */
+        disableDbgExt?: boolean;
     }
 
     interface ICookieMgr {
@@ -1009,6 +1018,16 @@ declare namespace ApplicationInsights {
         [key: string]: any;
     }
 
+    interface IDbgExtension {
+        isEnabled: () => boolean;
+        enable: () => void;
+        disable: () => void;
+        listener: INotificationListener;
+        sendEvt?: (name: string, data: any) => void;
+        debugMsg?: (name: string, data: any) => void;
+        diagLog?: (name: string, data: any) => void;
+    }
+
     interface IDiagnosticLogger {
         /**
          * When this is true the SDK will throw exceptions to aid in debugging.

package/dist/applicationinsights-core-js.js

@@ -1,5 +1,5 @@
 /*!
- * Application Insights JavaScript SDK - Core, 2.7.2-nightly.2111-10
+ * Application Insights JavaScript SDK - Core, 2.7.2-nightly.2111-12
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 (function (global, factory) {
@@ -1053,6 +1053,45 @@
         return isSupported;
     }
 
+    var listenerFuncs = ["eventsSent", "eventsDiscarded", "eventsSendRequest", "perfEvent"];
+    var _aiNamespace = null;
+    var _debugListener;
+    function _listenerProxyFunc(name, config) {
+        return function () {
+            var args = arguments;
+            var dbgExt = getDebugExt(config);
+            if (dbgExt) {
+                var listener = dbgExt.listener;
+                if (listener && listener[name]) {
+                    listener[name].apply(listener, args);
+                }
+            }
+        };
+    }
+    function _getExtensionNamespace() {
+        var target = getGlobalInst("Microsoft");
+        if (target) {
+            _aiNamespace = target["ApplicationInsights"];
+        }
+        return _aiNamespace;
+    }
+    function getDebugExt(config) {
+        var ns = _aiNamespace;
+        if (!ns && config.disableDbgExt !== true) {
+            ns = _aiNamespace || _getExtensionNamespace();
+        }
+        return ns ? ns["ChromeDbgExt"] : null;
+    }
+    function getDebugListener(config) {
+        if (!_debugListener) {
+            _debugListener = {};
+            for (var lp = 0; lp < listenerFuncs.length; lp++) {
+                _debugListener[listenerFuncs[lp]] = _listenerProxyFunc(listenerFuncs[lp], config);
+            }
+        }
+        return _debugListener;
+    }
+
     var AiNonUserActionablePrefix = "AI (Internal): ";
     var AiUserActionablePrefix = "AI: ";
     var AIInternalMessagePrefix = "AITR_";
@@ -1136,13 +1175,18 @@
                             }
                             _self.logInternalMessage(severity, message);
                         }
+                        else {
+                            _debugExtMsg("throw" + (severity === exports.LoggingSeverity.CRITICAL ? "Critical" : "Warning"), message);
+                        }
                     }
                 };
                 _self.warnToConsole = function (message) {
                     _logToConsole("warn", message);
+                    _debugExtMsg("warning", message);
                 };
                 _self.errorToConsole = function (message) {
                     _logToConsole("error", message);
+                    _debugExtMsg("error", message);
                 };
                 _self.resetInternalMessageCount = function () {
                     _messageCount = 0;
@@ -1164,12 +1208,18 @@
                         if (severity <= _self.telemetryLoggingLevel()) {
                             _self.queue.push(message);
                             _messageCount++;
+                            _debugExtMsg((severity === exports.LoggingSeverity.CRITICAL ? "error" : "warn"), message);
                         }
                         if (_messageCount === _self.maxInternalMessageLimit()) {
                             var throttleLimitMessage = "Internal events throttle limit per PageView reached for this app.";
                             var throttleMessage = new _InternalLogMessage(_InternalMessageId.MessageLimitPerPVExceeded, throttleLimitMessage, false);
                             _self.queue.push(throttleMessage);
-                            _self.warnToConsole(throttleLimitMessage);
+                            if (severity === exports.LoggingSeverity.CRITICAL) {
+                                _self.errorToConsole(throttleLimitMessage);
+                            }
+                            else {
+                                _self.warnToConsole(throttleLimitMessage);
+                            }
                         }
                     }
                 };
@@ -1183,6 +1233,12 @@
                 function _areInternalMessagesThrottled() {
                     return _messageCount >= _self.maxInternalMessageLimit();
                 }
+                function _debugExtMsg(name, data) {
+                    var dbgExt = getDebugExt(config);
+                    if (dbgExt && dbgExt.diagLog) {
+                        dbgExt.diagLog(name, data);
+                    }
+                }
             });
         }
         return DiagnosticLogger;
@@ -1974,6 +2030,9 @@
                     _notificationManager = notificationManager;
                     _self[strNotificationManager] = notificationManager;
                     _self.config = config || {};
+                    if (notificationManager && _self.config.disableDbgExt !== true) {
+                        notificationManager.addNotificationListener(getDebugListener(config));
+                    }
                     if (_self.config.enablePerfMgr) {
                         setValue(_self.config, "createPerfMgr", _createPerfManager);
                     }
@@ -2741,6 +2800,8 @@
     exports.getConsole = getConsole;
     exports.getCookie = getCookie;
     exports.getCrypto = getCrypto;
+    exports.getDebugExt = getDebugExt;
+    exports.getDebugListener = getDebugListener;
     exports.getDocument = getDocument;
     exports.getExceptionName = getExceptionName;
     exports.getGblPerfMgr = getGblPerfMgr;