@microsoft/applicationinsights-core-js 2.8.0 → 2.8.1

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

@@ -6582,7 +6582,7 @@
             },
             {
               "kind": "Content",
-              "text": "{\n    [key in keyof E]: [eValue: E[keyof E], mapValue: V[keyof V]];\n}"
+              "text": "{\n    [key in keyof E]: [E[keyof E], V[keyof V]];\n}"
             },
             {
               "kind": "Content",
@@ -15343,6 +15343,100 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!InstrumentEvent:function(1)",
+          "docComment": "/**\n * Add an instrumentation hook to the provided named \"event\" for the target class / object, this doesn't check whether the named \"event\" is in fact a function and just assigns the instrumentation hook to the target[evtName]\n *\n * @param target - The target object\n *\n * @param evtName - The name of the event\n *\n * @param callbacks - The callbacks to configure and call whenever the function is called\n *\n * @param checkPrototype - If the function doesn't exist on the target should it attempt to hook the prototype function\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function InstrumentEvent(target: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", evtName: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", callbacks: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IInstrumentHooksCallbacks",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IInstrumentHooksCallbacks:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", checkPrototype?: "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "IInstrumentHook",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IInstrumentHook:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 9,
+            "endIndex": 10
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "target",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "evtName",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "callbacks",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "checkPrototype",
+              "parameterTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "InstrumentEvent"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@microsoft/applicationinsights-core-js!InstrumentFunc:function(1)",

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

@@ -168,7 +168,7 @@ export function createUnloadHandlerContainer(): {
 
 // @public
 export function createValueMap<E, V = E>(values: {
-    [key in keyof E]: [eValue: E[keyof E], mapValue: V[keyof V]];
+    [key in keyof E]: [E[keyof E], V[keyof V]];
 }): V;
 
 // @public
@@ -776,6 +776,9 @@ export interface INotificationManager {
     removeNotificationListener(listener: INotificationListener): void;
 }
 
+// @public
+export function InstrumentEvent(target: any, evtName: string, callbacks: IInstrumentHooksCallbacks, checkPrototype?: boolean): IInstrumentHook;
+
 // @public
 export function InstrumentFunc(target: any, funcName: string, callbacks: IInstrumentHooksCallbacks, checkPrototype?: boolean): IInstrumentHook;
 

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

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 2.8.0
+ * Microsoft Application Insights Core Javascript SDK, 2.8.1
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -400,7 +400,7 @@ declare namespace ApplicationInsights {
      * @returns
      */
     function createValueMap<E, V = E>(values: {
-        [key in keyof E]: [eValue: E[keyof E], mapValue: V[keyof V]];
+        [key in keyof E]: [E[keyof E], V[keyof V]];
     }): V;
 
     /**
@@ -1722,6 +1722,16 @@ declare namespace ApplicationInsights {
         perfEvent?(perfEvent: IPerfEvent): void;
     }
 
+    /**
+     * Add an instrumentation hook to the provided named "event" for the target class / object, this doesn't check whether the
+     * named "event" is in fact a function and just assigns the instrumentation hook to the target[evtName]
+     * @param target - The target object
+     * @param evtName - The name of the event
+     * @param callbacks - The callbacks to configure and call whenever the function is called
+     * @param checkPrototype - If the function doesn't exist on the target should it attempt to hook the prototype function
+     */
+    function InstrumentEvent(target: any, evtName: string, callbacks: IInstrumentHooksCallbacks, checkPrototype?: boolean): IInstrumentHook;
+
     /**
      * Intercept the named prototype functions for the target class / object
      * @param target - The target object

package/dist/applicationinsights-core-js.js

@@ -1,5 +1,5 @@
 /*!
- * Application Insights JavaScript SDK - Core, 2.8.0
+ * Application Insights JavaScript SDK - Core, 2.8.1
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 (function (global, factory) {
@@ -1577,7 +1577,7 @@
     }
 
     var _objDefineProperty = ObjDefineProperty;
-    var version = "2.8.0";
+    var version = "2.8.1";
     var instanceName = "." + newId(6);
     var _dataUid = 0;
     function _createAccessor(target, prop, value) {
@@ -3940,13 +3940,15 @@
             }
             _doCallbacks(hooks, funcArgs, cbArgs, hookCtx, 0 );
             var theFunc = aiHook.f;
-            try {
-                funcArgs.rslt = theFunc.apply(funcThis, orgArgs);
-            }
-            catch (err) {
-                funcArgs.err = err;
-                _doCallbacks(hooks, funcArgs, cbArgs, hookCtx, 3 );
-                throw err;
+            if (theFunc) {
+                try {
+                    funcArgs.rslt = theFunc.apply(funcThis, orgArgs);
+                }
+                catch (err) {
+                    funcArgs.err = err;
+                    _doCallbacks(hooks, funcArgs, cbArgs, hookCtx, 3 );
+                    throw err;
+                }
             }
             _doCallbacks(hooks, funcArgs, cbArgs, hookCtx, 1 );
             return funcArgs.rslt;
@@ -3976,6 +3978,36 @@
         }
         return null;
     }
+    function _createInstrumentHook(owner, funcName, fn, callbacks) {
+        var aiHook = fn && fn[aiInstrumentHooks];
+        if (!aiHook) {
+            aiHook = {
+                i: 0,
+                n: funcName,
+                f: fn,
+                h: []
+            };
+            var newFunc = _createFunctionHook(aiHook);
+            newFunc[aiInstrumentHooks] = aiHook;
+            owner[funcName] = newFunc;
+        }
+        var theHook = {
+            id: aiHook.i,
+            cbks: callbacks,
+            rm: function () {
+                var id = this.id;
+                _arrLoop(aiHook.h, function (hook, idx) {
+                    if (hook.id === id) {
+                        aiHook.h.splice(idx, 1);
+                        return 1;
+                    }
+                });
+            }
+        };
+        aiHook.i++;
+        aiHook.h.push(theHook);
+        return theHook;
+    }
     function InstrumentFunc(target, funcName, callbacks, checkPrototype) {
         if (checkPrototype === void 0) { checkPrototype = true; }
         if (target && funcName && callbacks) {
@@ -3983,34 +4015,7 @@
             if (owner) {
                 var fn = owner[funcName];
                 if (typeof fn === strShimFunction) {
-                    var aiHook_1 = fn[aiInstrumentHooks];
-                    if (!aiHook_1) {
-                        aiHook_1 = {
-                            i: 0,
-                            n: funcName,
-                            f: fn,
-                            h: []
-                        };
-                        var newFunc = _createFunctionHook(aiHook_1);
-                        newFunc[aiInstrumentHooks] = aiHook_1;
-                        owner[funcName] = newFunc;
-                    }
-                    var theHook = {
-                        id: aiHook_1.i,
-                        cbks: callbacks,
-                        rm: function () {
-                            var id = this.id;
-                            _arrLoop(aiHook_1.h, function (hook, idx) {
-                                if (hook.id === id) {
-                                    aiHook_1.h.splice(idx, 1);
-                                    return 1;
-                                }
-                            });
-                        }
-                    };
-                    aiHook_1.i++;
-                    aiHook_1.h.push(theHook);
-                    return theHook;
+                    return _createInstrumentHook(owner, funcName, fn, callbacks);
                 }
             }
         }
@@ -4030,6 +4035,16 @@
         });
         return hooks;
     }
+    function InstrumentEvent(target, evtName, callbacks, checkPrototype) {
+        if (checkPrototype === void 0) { checkPrototype = true; }
+        if (target && evtName && callbacks) {
+            var owner = _getOwner(target, evtName, checkPrototype);
+            if (owner) {
+                return _createInstrumentHook(owner, evtName, owner[evtName], callbacks);
+            }
+        }
+        return null;
+    }
 
     exports.AppInsightsCore = AppInsightsCore;
     exports.BaseCore = BaseCore;
@@ -4038,6 +4053,7 @@
     exports.DiagnosticLogger = DiagnosticLogger;
     exports.EventHelper = EventHelper;
     exports.EventsDiscardedReason = EventsDiscardedReason;
+    exports.InstrumentEvent = InstrumentEvent;
     exports.InstrumentFunc = InstrumentFunc;
     exports.InstrumentFuncs = InstrumentFuncs;
     exports.InstrumentProto = InstrumentProto;