@microsoft/applicationinsights-dependencies-js 2.8.0-beta.2203-09 → 2.8.0-beta.2203-12

package/src/ajax.ts

@@ -10,7 +10,8 @@ import {
     isNullOrUndefined, arrForEach, isString, strTrim, isFunction, LoggingSeverity, _InternalMessageId,
     IAppInsightsCore, BaseTelemetryPlugin, ITelemetryPluginChain, IConfiguration, IPlugin, ITelemetryItem, IProcessTelemetryContext,
     getLocation, getGlobal, strPrototype, IInstrumentCallDetails, InstrumentFunc, InstrumentProto, getPerformance,
-    IInstrumentHooksCallbacks, objForEachKey, generateW3CId, getIEVersion, dumpObj, ICustomProperties, isXhrSupported, eventOn, mergeEvtNamespace, createUniqueNamespace
+    IInstrumentHooksCallbacks, objForEachKey, generateW3CId, getIEVersion, dumpObj, ICustomProperties, isXhrSupported, eventOn,
+    mergeEvtNamespace, createUniqueNamespace, createProcessTelemetryContext
 } from "@microsoft/applicationinsights-core-js";
 import { ajaxRecord, IAjaxRecordResponse } from "./ajaxRecord";
 import { Traceparent } from "./TraceParent";
@@ -21,6 +22,7 @@ const strDiagLog = "diagLog";
 const strAjaxData = "ajaxData";
 const strThrowInternal = "throwInternal";
 const strFetch = "fetch";
+const strTrackDependencyDataInternal = "trackDependencyDataInternal"; // Using string to help with minification
 
 // Using a global value so that to handle same iKey with multiple app insights instances (mostly for testing)
 let _markCount: number = 0;
@@ -198,23 +200,23 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
 
     constructor() {
         super();
-        let strTrackDependencyDataInternal = "trackDependencyDataInternal"; // Using string to help with minification
-        let location = getLocation();
-        let _fetchInitialized:boolean = false;      // fetch monitoring initialized
-        let _xhrInitialized:boolean = false;        // XHR monitoring initialized
-        let _currentWindowHost:string = location && location.host && location.host.toLowerCase();
-        let _config: ICorrelationConfig = AjaxMonitor.getEmptyConfig();
-        let _enableRequestHeaderTracking = false;
-        let _enableAjaxErrorStatusText = false;
-        let _trackAjaxAttempts: number = 0;
+        let _fetchInitialized: boolean;      // fetch monitoring initialized
+        let _xhrInitialized: boolean;        // XHR monitoring initialized
+        let _currentWindowHost: string;
+        let _config: ICorrelationConfig;
+        let _enableRequestHeaderTracking: boolean;
+        let _enableAjaxErrorStatusText: boolean;
+        let _trackAjaxAttempts: number;
         let _context: ITelemetryContext;
         let _isUsingW3CHeaders: boolean;
         let _isUsingAIHeaders: boolean;
         let _markPrefix: string;
-        let _enableAjaxPerfTracking:boolean = false;
-        let _maxAjaxCallsPerView:number = 0;
-        let _enableResponseHeaderTracking:boolean = false;
-        let _disabledUrls:any = {};
+        let _enableAjaxPerfTracking: boolean;
+        let _maxAjaxCallsPerView: number;
+        let _enableResponseHeaderTracking: boolean;
+        let _disabledUrls: any;
+        let _disableAjaxTracking: boolean;
+        let _disableFetchTracking: boolean;
         let _excludeRequestFromAutoTrackingPatterns: string[] | RegExp[];
         let _addRequestContext: (requestContext?: IRequestContext) => ICustomProperties;
         let _evtNamespace: string | string[];
@@ -222,63 +224,24 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
         dynamicProto(AjaxMonitor, this, (_self, _base) => {
             let _addHook = _base._addHook;
 
+            _initDefaults();
+
             _self.initialize = (config: IConfiguration & IConfig, core: IAppInsightsCore, extensions: IPlugin[], pluginChain?:ITelemetryPluginChain) => {
                 if (!_self.isInitialized()) {
                     _base.initialize(config, core, extensions, pluginChain);
-                    let ctx = _self._getTelCtx();
-                    const defaultConfig = AjaxMonitor.getDefaultConfig();
-                    objForEachKey(defaultConfig, (field, value) => {
-                        _config[field] = ctx.getConfig(AjaxMonitor.identifier, field, value);
-                    });
 
                     _evtNamespace = mergeEvtNamespace(createUniqueNamespace("ajax"), core && core.evtNamespace && core.evtNamespace());
 
-                    let distributedTracingMode = _config.distributedTracingMode;
-                    _enableRequestHeaderTracking = _config.enableRequestHeaderTracking;
-                    _enableAjaxErrorStatusText = _config.enableAjaxErrorStatusText;
-                    _enableAjaxPerfTracking = _config.enableAjaxPerfTracking;
-                    _maxAjaxCallsPerView = _config.maxAjaxCallsPerView;
-                    _enableResponseHeaderTracking = _config.enableResponseHeaderTracking;
-                    _excludeRequestFromAutoTrackingPatterns = _config.excludeRequestFromAutoTrackingPatterns;
-                    _addRequestContext = _config.addRequestContext;
-
-                    _isUsingAIHeaders = distributedTracingMode === eDistributedTracingModes.AI || distributedTracingMode === eDistributedTracingModes.AI_AND_W3C;
-                    _isUsingW3CHeaders = distributedTracingMode === eDistributedTracingModes.AI_AND_W3C || distributedTracingMode === eDistributedTracingModes.W3C;
-                    if (_enableAjaxPerfTracking) {
-                        let iKey = config.instrumentationKey || "unkwn";
-                        if (iKey.length > 5) {
-                            _markPrefix = AJAX_MONITOR_PREFIX + iKey.substring(iKey.length - 5) + ".";
-                        } else {
-                            _markPrefix = AJAX_MONITOR_PREFIX + iKey + ".";
-                        }
-                    }
-
-                    if (_config.disableAjaxTracking === false) {
-                        _instrumentXhr();
-                    }
+                    _populateDefaults(config);
 
+                    _instrumentXhr();
                     _instrumentFetch();
-
-                    if (extensions.length > 0 && extensions) {
-                        let propExt: any, extIx = 0;
-                        while (!propExt && extIx < extensions.length) {
-                            if (extensions[extIx] && extensions[extIx].identifier === PropertiesPluginIdentifier) {
-                                propExt = extensions[extIx];
-                            }
-
-                            extIx++;
-                        }
-                        
-                        if (propExt) {
-                            _context = propExt.context; // we could move IPropertiesPlugin to common as well
-                        }
-                    }
+                    _populateContext();
                 }
             };
 
             _self._doTeardown = () => {
-                _fetchInitialized = false;
-                _xhrInitialized = false;
+                _initDefaults();
             };
 
             _self.trackDependencyData = (dependency: IDependencyTelemetry, properties?: { [key: string]: any }) => {
@@ -385,6 +348,73 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                 ++_trackAjaxAttempts;
             }
 
+            function _initDefaults() {
+                let location = getLocation();
+                _fetchInitialized = false;      // fetch monitoring initialized
+                _xhrInitialized = false;        // XHR monitoring initialized
+                _currentWindowHost = location && location.host && location.host.toLowerCase();
+                _config = AjaxMonitor.getEmptyConfig();
+                _enableRequestHeaderTracking = false;
+                _enableAjaxErrorStatusText = false;
+                _trackAjaxAttempts = 0;
+                _context = null;
+                _isUsingW3CHeaders = false;
+                _isUsingAIHeaders = false;
+                _markPrefix = null;
+                _enableAjaxPerfTracking = false;
+                _maxAjaxCallsPerView = 0;
+                _enableResponseHeaderTracking = false;
+                _disabledUrls = {};
+                _disableAjaxTracking = false;
+                _disableFetchTracking = true;
+        
+                _excludeRequestFromAutoTrackingPatterns = null
+                _addRequestContext = null;
+                _evtNamespace = null;
+            }
+
+            function _populateDefaults(config: IConfiguration) {
+                let ctx = createProcessTelemetryContext(null, config, _self.core);
+
+                // Reset to the empty config
+                _config = AjaxMonitor.getEmptyConfig();
+                const defaultConfig = AjaxMonitor.getDefaultConfig();
+                objForEachKey(defaultConfig, (field, value) => {
+                    _config[field] = ctx.getConfig(AjaxMonitor.identifier, field, value);
+                });
+    
+                let distributedTracingMode = _config.distributedTracingMode;
+                _enableRequestHeaderTracking = _config.enableRequestHeaderTracking;
+                _enableAjaxErrorStatusText = _config.enableAjaxErrorStatusText;
+                _enableAjaxPerfTracking = _config.enableAjaxPerfTracking;
+                _maxAjaxCallsPerView = _config.maxAjaxCallsPerView;
+                _enableResponseHeaderTracking = _config.enableResponseHeaderTracking;
+                _excludeRequestFromAutoTrackingPatterns = _config.excludeRequestFromAutoTrackingPatterns;
+                _addRequestContext = _config.addRequestContext;
+    
+                _isUsingAIHeaders = distributedTracingMode === eDistributedTracingModes.AI || distributedTracingMode === eDistributedTracingModes.AI_AND_W3C;
+                _isUsingW3CHeaders = distributedTracingMode === eDistributedTracingModes.AI_AND_W3C || distributedTracingMode === eDistributedTracingModes.W3C;
+
+                if (_enableAjaxPerfTracking) {
+                    let iKey = config.instrumentationKey || "unkwn";
+                    if (iKey.length > 5) {
+                        _markPrefix = AJAX_MONITOR_PREFIX + iKey.substring(iKey.length - 5) + ".";
+                    } else {
+                        _markPrefix = AJAX_MONITOR_PREFIX + iKey + ".";
+                    }
+                }
+
+                _disableAjaxTracking = !!_config.disableAjaxTracking;
+                _disableFetchTracking = !!_config.disableFetchTracking;
+            }
+
+            function _populateContext() {
+                let propExt = _self.core.getPlugin<any>(PropertiesPluginIdentifier);
+                if (propExt) {
+                    _context = propExt.plugin.context; // we could move IPropertiesPlugin to common as well
+                }
+            }
+
             // discard the header if it's defined as ignoreHeaders in ICorrelationConfig
             function _canIncludeHeaders(header: string) {
                 let rlt = true;
@@ -408,13 +438,13 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
 
                 let global = getGlobal();
                 let isPolyfill = (fetch as any).polyfill;
-                if (_config.disableFetchTracking === false) {
+                if (!_disableFetchTracking && !_fetchInitialized) {
                     _addHook(InstrumentFunc(global, strFetch, {
                         ns: _evtNamespace,
                         // Add request hook
                         req: (callDetails: IInstrumentCallDetails, input, init) => {
                             let fetchData: ajaxRecord;
-                            if (_fetchInitialized &&
+                            if (!_disableFetchTracking && _fetchInitialized &&
                                     !_isDisabledRequest(null, input, init) &&
                                     // If we have a polyfil and XHR instrumented then let XHR report otherwise we get duplicates
                                     !(isPolyfill && _xhrInitialized)) {
@@ -428,35 +458,39 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                             }
                         },
                         rsp: (callDetails: IInstrumentCallDetails, input) => {
-                            let fetchData = callDetails.ctx().data;
-                            if (fetchData) {
-                                // Replace the result with the new promise from this code
-                                callDetails.rslt = callDetails.rslt.then((response: any) => {
-                                    _reportFetchMetrics(callDetails, (response||{}).status, input, response, fetchData, () => {
-                                        let ajaxResponse:IAjaxRecordResponse = {
-                                            statusText: response.statusText,
-                                            headerMap: null,
-                                            correlationContext: _getFetchCorrelationContext(response)
-                                        };
-
-                                        if (_enableResponseHeaderTracking) {
-                                            const responseHeaderMap = {};
-                                            response.headers.forEach((value: string, name: string) => {
-                                                if (_canIncludeHeaders(name)) { responseHeaderMap[name] = value; }
-                                            });
-
-                                            ajaxResponse.headerMap = responseHeaderMap;
-                                        }
-
-                                        return ajaxResponse;
-                                    });
-
-                                    return response;
-                                })
-                                .catch((reason: any) => {
-                                    _reportFetchMetrics(callDetails, 0, input, null, fetchData, null, { error: reason.message });
-                                    throw reason;
-                                });
+                            if (!_disableFetchTracking) {
+                                let fetchData = callDetails.ctx().data;
+                                if (fetchData) {
+                                    // Replace the result with the new promise from this code
+                                    callDetails.rslt = callDetails.rslt.then((response: any) => {
+                                        _reportFetchMetrics(callDetails, (response||{}).status, input, response, fetchData, () => {
+                                            let ajaxResponse:IAjaxRecordResponse = {
+                                                statusText: response.statusText,
+                                                headerMap: null,
+                                                correlationContext: _getFetchCorrelationContext(response)
+                                            };
+    
+                                            if (_enableResponseHeaderTracking) {
+                                                const responseHeaderMap = {};
+                                                response.headers.forEach((value: string, name: string) => {
+                                                    if (_canIncludeHeaders(name)) {
+                                                        responseHeaderMap[name] = value;
+                                                    }
+                                                });
+    
+                                                ajaxResponse.headerMap = responseHeaderMap;
+                                            }
+    
+                                            return ajaxResponse;
+                                        });
+    
+                                        return response;
+                                    })
+                                        .catch((reason: any) => {
+                                            _reportFetchMetrics(callDetails, 0, input, null, fetchData, null, { error: reason.message });
+                                            throw reason;
+                                        });
+                                }
                             }
                         },
                         // Create an error callback to report any hook errors
@@ -493,21 +527,23 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
             }
 
             function _instrumentXhr():void {
-                if (_supportsAjaxMonitoring(_self) && !_xhrInitialized) {
+                if (_supportsAjaxMonitoring(_self) && !_disableAjaxTracking && !_xhrInitialized) {
                     // Instrument open
                     _hookProto(XMLHttpRequest, "open", {
                         ns: _evtNamespace,
                         req: (args:IInstrumentCallDetails, method:string, url:string, async?:boolean) => {
-                            let xhr = args.inst as XMLHttpRequestInstrumented;
-                            let ajaxData = xhr[strAjaxData];
-                            if (!_isDisabledRequest(xhr, url) && _isMonitoredXhrInstance(xhr, true)) {
-                                if (!ajaxData || !ajaxData.xhrMonitoringState.openDone) {
-                                    // Only create a single ajaxData (even when multiple AI instances are running)
-                                    _openHandler(xhr, method, url, async);
+                            if (!_disableAjaxTracking) {
+                                let xhr = args.inst as XMLHttpRequestInstrumented;
+                                let ajaxData = xhr[strAjaxData];
+                                if (!_isDisabledRequest(xhr, url) && _isMonitoredXhrInstance(xhr, true)) {
+                                    if (!ajaxData || !ajaxData.xhrMonitoringState.openDone) {
+                                        // Only create a single ajaxData (even when multiple AI instances are running)
+                                        _openHandler(xhr, method, url, async);
+                                    }
+    
+                                    // always attach to the on ready state change (required for handling multiple instances)
+                                    _attachToOnReadyStateChange(xhr);
                                 }
-
-                                // always attach to the on ready state change (required for handling multiple instances)
-                                _attachToOnReadyStateChange(xhr);
                             }
                         },
                         hkErr: _createErrorCallbackFunc(_self, _InternalMessageId.FailedMonitorAjaxOpen,
@@ -518,13 +554,15 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                     _hookProto(XMLHttpRequest, "send", {
                         ns: _evtNamespace,
                         req: (args:IInstrumentCallDetails, context?: Document | BodyInit | null) => {
-                            let xhr = args.inst as XMLHttpRequestInstrumented;
-                            let ajaxData = xhr[strAjaxData];
-                            if (_isMonitoredXhrInstance(xhr) && !ajaxData.xhrMonitoringState.sendDone) {
-                                _createMarkId("xhr", ajaxData);
-                                ajaxData.requestSentTime = dateTimeUtilsNow();
-                                _self.includeCorrelationHeaders(ajaxData, undefined, undefined, xhr);
-                                ajaxData.xhrMonitoringState.sendDone = true;
+                            if (!_disableAjaxTracking) {
+                                let xhr = args.inst as XMLHttpRequestInstrumented;
+                                let ajaxData = xhr[strAjaxData];
+                                if (_isMonitoredXhrInstance(xhr) && !ajaxData.xhrMonitoringState.sendDone) {
+                                    _createMarkId("xhr", ajaxData);
+                                    ajaxData.requestSentTime = dateTimeUtilsNow();
+                                    _self.includeCorrelationHeaders(ajaxData, undefined, undefined, xhr);
+                                    ajaxData.xhrMonitoringState.sendDone = true;
+                                }
                             }
                         },
                         hkErr: _createErrorCallbackFunc(_self, _InternalMessageId.FailedMonitorAjaxSend,
@@ -533,12 +571,15 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
 
                     // Instrument abort
                     _hookProto(XMLHttpRequest, "abort", {
+                        ns: _evtNamespace,
                         req: (args:IInstrumentCallDetails) => {
-                            let xhr = args.inst as XMLHttpRequestInstrumented;
-                            let ajaxData = xhr[strAjaxData];
-                            if (_isMonitoredXhrInstance(xhr) && !ajaxData.xhrMonitoringState.abortDone) {
-                                ajaxData.aborted = 1;
-                                ajaxData.xhrMonitoringState.abortDone = true;
+                            if (!_disableAjaxTracking) {
+                                let xhr = args.inst as XMLHttpRequestInstrumented;
+                                let ajaxData = xhr[strAjaxData];
+                                if (_isMonitoredXhrInstance(xhr) && !ajaxData.xhrMonitoringState.abortDone) {
+                                    ajaxData.aborted = 1;
+                                    ajaxData.xhrMonitoringState.abortDone = true;
+                                }
                             }
                         },
                         hkErr: _createErrorCallbackFunc(_self, _InternalMessageId.FailedMonitorAjaxAbort,
@@ -546,18 +587,19 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                     });
 
                     // Instrument setRequestHeader
-                    if (_enableRequestHeaderTracking) {
-                        _hookProto(XMLHttpRequest, "setRequestHeader", {
-                            req: (args: IInstrumentCallDetails, header: string, value: string) => {
+                    _hookProto(XMLHttpRequest, "setRequestHeader", {
+                        ns: _evtNamespace,
+                        req: (args: IInstrumentCallDetails, header: string, value: string) => {
+                            if (!_disableAjaxTracking && _enableRequestHeaderTracking) {
                                 let xhr = args.inst as XMLHttpRequestInstrumented;
                                 if (_isMonitoredXhrInstance(xhr) && _canIncludeHeaders(header)) {
                                     xhr[strAjaxData].requestHeaders[header] = value;
                                 }
-                            },
-                            hkErr: _createErrorCallbackFunc(_self, _InternalMessageId.FailedMonitorAjaxSetRequestHeader,
-                                "Failed to monitor XMLHttpRequest.setRequestHeader, monitoring data for this ajax call may be incorrect.")
-                        });
-                    }
+                            }
+                        },
+                        hkErr: _createErrorCallbackFunc(_self, _InternalMessageId.FailedMonitorAjaxSetRequestHeader,
+                            "Failed to monitor XMLHttpRequest.setRequestHeader, monitoring data for this ajax call may be incorrect.")
+                    });
 
                     _xhrInitialized = true;
                 }
@@ -733,7 +775,9 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                                         const parts = line.split(": ");
                                         const header = parts.shift();
                                         const value = parts.join(": ");
-                                        if(_canIncludeHeaders(header)) { responseHeaderMap[header] = value; }
+                                        if(_canIncludeHeaders(header)) {
+                                            responseHeaderMap[header] = value;
+                                        }
                                     });
 
                                     ajaxResponse.headerMap = responseHeaderMap;
@@ -761,9 +805,9 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                             _self[strTrackDependencyDataInternal](dependency);
                         } else {
                             _reportXhrError(null, {
-                                    requestSentTime: ajaxData.requestSentTime,
-                                    responseFinishedTime: ajaxData.responseFinishedTime
-                                });
+                                requestSentTime: ajaxData.requestSentTime,
+                                responseFinishedTime: ajaxData.responseFinishedTime
+                            });
                         }
                     } finally {
                         // cleanup telemetry data
@@ -903,7 +947,9 @@ export class AjaxMonitor extends BaseTelemetryPlugin implements IDependenciesPlu
                 if (_enableRequestHeaderTracking) {
                     let headers = new Headers((init ? init.headers : 0) || (input instanceof Request ? (input.headers || {}) : {}));
                     headers.forEach((value, key) => {
-                        if (_canIncludeHeaders(key)) { requestHeaders[key] = value; }
+                        if (_canIncludeHeaders(key)) {
+                            requestHeaders[key] = value;
+                        }
                     });
                 }
 

package/types/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.19.4"
+      "packageVersion": "7.19.5"
     }
   ]
 }