@microsoft/applicationinsights-analytics-js 3.3.5-nightly3.2411-14 → 3.3.5-nightly3.2412-01

package/types/applicationinsights-analytics-js.namespaced.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights JavaScript SDK - Web Analytics, 3.3.5-nightly3.2411-14
+ * Microsoft Application Insights JavaScript SDK - Web Analytics, 3.3.5-nightly3.2412-01
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -39,8 +39,8 @@ declare namespace ApplicationInsights {
         }): void;
         /**
          * @description Log a diagnostic message
-         * @param trace
-         * @param ICustomProperties.
+         * @param trace - the trace message
+         * @param customProperties - Additional custom properties to include in the event
          */
         trackTrace(trace: ITraceTelemetry, customProperties?: ICustomProperties): void;
         /**
@@ -74,8 +74,8 @@ declare namespace ApplicationInsights {
         }): void;
         /**
          * @ignore INTERNAL ONLY
-         * @param pageViewPerformance
-         * @param properties
+         * @param pageViewPerformance - The page view performance item to be sent
+         * @param properties - Custom properties (Part C) that a user can add to the telemetry item
          */
         sendPageViewPerformanceInternal(pageViewPerformance: IPageViewPerformanceTelemetryInternal, properties?: {
             [key: string]: any;
@@ -84,8 +84,8 @@ declare namespace ApplicationInsights {
         }): void;
         /**
          * Send browser performance metrics.
-         * @param pageViewPerformance
-         * @param customProperties
+         * @param pageViewPerformance - The page view performance item to be sent
+         * @param customProperties - Additional data used to filter pages and metrics in the portal. Defaults to empty.
          */
         trackPageViewPerformance(pageViewPerformance: IPageViewPerformanceTelemetry, customProperties?: ICustomProperties): void;
         /**
@@ -110,9 +110,9 @@ declare namespace ApplicationInsights {
         }): void;
         /**
          * @ignore INTERNAL ONLY
-         * @param exception
-         * @param properties
-         * @param systemProperties
+         * @param exception - The exception item to be sent
+         * @param properties - Custom properties (Part C) that a user can add to the telemetry item
+         * @param systemProperties - System level properties (Part A) that a user can add to the telemetry item
          */
         sendExceptionInternal(exception: IExceptionTelemetry, customProperties?: {
             [key: string]: any;
@@ -130,7 +130,7 @@ declare namespace ApplicationInsights {
         trackException(exception: IExceptionTelemetry, customProperties?: ICustomProperties): void;
         /**
          * @description Custom error handler for Application Insights Analytics
-         * @param exception
+         * @param exception - The exception item to be sent
          */
         _onerror(exception: IAutoExceptionTelemetry): void;
         addTelemetryInitializer(telemetryInitializer: (item: ITelemetryItem) => boolean | void): ITelemetryInitializerHandler;
@@ -550,7 +550,6 @@ declare namespace ApplicationInsights {
         unload(isAsync?: boolean, unloadComplete?: (unloadState: ITelemetryUnloadState) => void, cbTimeout?: number): void | IPromise<ITelemetryUnloadState>;
         /**
          * Find and return the (first) plugin with the specified identifier if present
-         * @param pluginIdentifier
          */
         getPlugin<T extends IPlugin = IPlugin>(pluginIdentifier: string): ILoadedPlugin<T>;
         /**
@@ -605,7 +604,6 @@ declare namespace ApplicationInsights {
         /**
          * Watches and tracks changes for accesses to the current config, and if the accessed config changes the
          * handler will be recalled.
-         * @param handler
          * @returns A watcher handler instance that can be used to remove itself when being unloaded
          */
         onCfgChange(handler: WatcherFunction<CfgType>): IUnloadHook;
@@ -646,47 +644,38 @@ declare namespace ApplicationInsights {
     interface IAutoExceptionTelemetry {
         /**
          * @description error message. Available as event in HTML onerror="" handler
-         * @type {string}
          */
         message: string;
         /**
          * @description URL of the script where the error was raised
-         * @type {string}
          */
         url: string;
         /**
          * @description Line number where error was raised
-         * @type {number}
          */
         lineNumber: number;
         /**
          * @description Column number for the line where the error occurred
-         * @type {number}
          */
         columnNumber: number;
         /**
          * @description Error Object (object)
-         * @type {any}
          */
         error: any;
         /**
          * @description The event at the time of the exception (object)
-         * @type {Event|string}
          */
         evt?: Event | string;
         /**
          * @description The provided stack for the error
-         * @type {IStackDetails}
          */
         stackDetails?: IStackDetails;
         /**
          * @description The calculated type of the error
-         * @type {string}
          */
         typeName?: string;
         /**
          * @description The descriptive source of the error
-         * @type {string}
          */
         errorSrc?: string;
     }
@@ -913,7 +902,7 @@ declare namespace ApplicationInsights {
          */
         disableFlushOnBeforeUnload?: boolean;
         /**
-         * Default value of {@link #disableFlushOnBeforeUnload}. If true, flush method will not be called when onPageHide or onVisibilityChange (hidden state) event(s) trigger.
+         * Default value of `disableFlushOnBeforeUnload`. If true, flush method will not be called when onPageHide or onVisibilityChange (hidden state) event(s) trigger.
          */
         disableFlushOnUnload?: boolean;
         /**
@@ -965,12 +954,12 @@ declare namespace ApplicationInsights {
          */
         isStorageUseDisabled?: boolean;
         /**
-         * If false, the SDK will send all telemetry using the [Beacon API](https://www.w3.org/TR/beacon)
+         * If false, the SDK will send all telemetry using the <a href="https://www.w3.org/TR/beacon">Beacon API</a>.
          * @defaultValue true
          */
         isBeaconApiDisabled?: boolean;
         /**
-         * Don't use XMLHttpRequest or XDomainRequest (for IE < 9) by default instead attempt to use fetch() or sendBeacon.
+         * Don't use XMLHttpRequest or XDomainRequest (for IE \< 9) by default instead attempt to use fetch() or sendBeacon.
          * If no other transport is available it will still use XMLHttpRequest
          */
         disableXhr?: boolean;
@@ -1227,8 +1216,8 @@ declare namespace ApplicationInsights {
          * be logged to console if their severity meets the configured loggingConsoleLevel
          *
          * 0: ALL console logging off
-         * 1: logs to console: severity >= CRITICAL
-         * 2: logs to console: severity >= WARNING
+         * 1: logs to console: severity \>= CRITICAL
+         * 2: logs to console: severity \>= WARNING
          */
         loggingLevelConsole?: number;
         /**
@@ -1237,8 +1226,8 @@ declare namespace ApplicationInsights {
          * the configured instrumentation key.
          *
          * 0: ALL iKey logging off
-         * 1: logs to iKey: severity >= CRITICAL
-         * 2: logs to iKey: severity >= WARNING
+         * 1: logs to iKey: severity \>= CRITICAL
+         * 2: logs to iKey: severity \>= WARNING
          */
         loggingLevelTelemetry?: number;
         /**
@@ -1265,7 +1254,6 @@ declare namespace ApplicationInsights {
          */
         readonly channels?: IChannelControls[][];
         /**
-         * @type {boolean}
          * Flag that disables the Instrumentation Key validation.
          */
         disableInstrumentationKeyValidation?: boolean;
@@ -1296,14 +1284,12 @@ declare namespace ApplicationInsights {
         /**
          * @description Custom cookie domain. This is helpful if you want to share Application Insights cookies across subdomains. It
          * can be set here or as part of the cookieCfg.domain, the cookieCfg takes precedence if both are specified.
-         * @type {string}
          * @defaultValue ""
          */
         cookieDomain?: string;
         /**
          * @description Custom cookie path. This is helpful if you want to share Application Insights cookies behind an application
          * gateway. It can be set here or as part of the cookieCfg.domain, the cookieCfg takes precedence if both are specified.
-         * @type {string}
          * @defaultValue ""
          */
         cookiePath?: string;
@@ -1415,7 +1401,7 @@ declare namespace ApplicationInsights {
         /**
          * Optional Callback hook to allow the cookie manager to update it's configuration, not generally implemented now that
          * dynamic configuration is supported
-         * @param updateState
+         * @param updateState - The new configuration state to apply to the cookie manager
          */
         update?(updateState: ITelemetryUpdateState): void;
         /**
@@ -1529,7 +1515,7 @@ declare namespace ApplicationInsights {
         logInternalMessage?(severity: LoggingSeverity, message: _InternalLogMessage): void;
         /**
          * Optional Callback hook to allow the diagnostic logger to update it's configuration
-         * @param updateState
+         * @param updateState - The new configuration state to apply to the diagnostic logger
          */
         update?(updateState: ITelemetryUpdateState): void;
         /**
@@ -1550,7 +1536,7 @@ declare namespace ApplicationInsights {
         getName(): string;
         /**
          * Sets the current name of the page
-         * @param pageName
+         * @param pageName - The name of the page
          */
         setName(pageName: string): void;
         /**
@@ -1582,7 +1568,7 @@ declare namespace ApplicationInsights {
         getTraceFlags(): number | undefined;
         /**
          * https://www.w3.org/TR/trace-context/#trace-flags
-         * @param newValue
+         * @param newValue - An integer representation of the W3C TraceContext trace-flags.
          */
         setTraceFlags(newValue?: number): void;
     }
@@ -1590,12 +1576,10 @@ declare namespace ApplicationInsights {
     interface IEventTelemetry extends IPartC {
         /**
          * @description An event name string
-         * @type {string}
          */
         name: string;
         /**
          * @description custom defined iKey
-         * @type {string}
          */
         iKey?: string;
     }
@@ -1634,10 +1618,10 @@ declare namespace ApplicationInsights {
          *
          * This callback is called before telemetry data is sent, allowing for dynamic customization of the logs.
          *
-         * @returns {Object} An object with the following property:
+         * @returns An object with the following property:
          * - logs: An array of strings, where each string represents a log entry to be included in the telemetry.
          *
-         * @property {number} maxLogs - Specifies the maximum number of logs that can be generated. If not explicitly set, it defaults to 50.
+         * @property maxLogs - Specifies the maximum number of logs that can be generated. If not explicitly set, it defaults to 50.
          */
         expLog?: () => {
             logs: string[];
@@ -1661,20 +1645,17 @@ declare namespace ApplicationInsights {
          */
         id?: string;
         /**
-         * @deprecated
-         * @type {Error}
-         * @description DEPRECATED: Please use exception instead. Behavior/usage for exception remains the same as this field.
+         * @deprecated Please use the `exception` field instead. The behavior and usage of `exception` remains the same as this field.
+         * Unique guid identifying this error.
          */
         error?: Error;
         /**
-         * @type {Error}
          * @description Error Object(s)
          */
         exception?: Error | IAutoExceptionTelemetry;
         /**
          * @description Specified severity of exception for use with
          * telemetry filtering in dashboard
-         * @type {(SeverityLevel | number)}
          */
         severityLevel?: SeverityLevel | number;
     }
@@ -1725,32 +1706,31 @@ declare namespace ApplicationInsights {
         getUrl: () => string;
         /**
          * Create payload data
-         * @param data data
          * @returns IPayloadData
          */
         createPayload: (data: string | Uint8Array) => IPayloadData;
         /**
          * Serialize an item into a string
-         * @param input telemetry item
-         * @param convertUndefined convert undefined to a custom-defined object
+         * @param input - telemetry item
+         * @param convertUndefined - convert undefined to a custom-defined object
          * @returns Serialized string
          */
         serialize?: (input: ITelemetryItem, convertUndefined?: any) => string;
         /**
          * Batch an array of strings into one string
-         * @param arr array of strings
+         * @param arr - array of strings
          * @returns a string represent all items in the given array
          */
         batch?: (arr: string[]) => string;
         /**
          * If the item should be processed by offline channel
-         * @param evt telemetry item
+         * @param evt - telemetry item
          * @returns should process or not
          */
         shouldProcess?: (evt: ITelemetryItem) => boolean;
         /**
          * Create 1ds payload data
-         * @param evts ITelemetryItems
+         * @param evts - ITelemetryItems
          * @returns IPayloadData
          */
         createOneDSPayload?: (evts: ITelemetryItem[]) => IPayloadData;
@@ -1787,29 +1767,24 @@ declare namespace ApplicationInsights {
     interface IMetricTelemetry extends IPartC {
         /**
          * @description (required) - name of this metric
-         * @type {string}
          */
         name: string;
         /**
          * @description (required) - Recorded value/average for this metric
-         * @type {number}
          */
         average: number;
         /**
          * @description (optional) Number of samples represented by the average.
-         * @type {number=}
          * @default sampleCount=1
          */
         sampleCount?: number;
         /**
          * @description (optional) The smallest measurement in the sample. Defaults to the average
-         * @type {number}
          * @default min=average
          */
         min?: number;
         /**
          * @description (optional) The largest measurement in the sample. Defaults to the average.
-         * @type {number}
          * @default max=average
          */
         max?: number;
@@ -1819,7 +1794,6 @@ declare namespace ApplicationInsights {
         stdDev?: number;
         /**
          * @description custom defined iKey
-         * @type {string}
          */
         iKey?: string;
     }
@@ -1850,7 +1824,7 @@ declare namespace ApplicationInsights {
         /**
          * [Optional] This event is sent if you have enabled perf events, they are primarily used to track internal performance testing and debugging
          * the event can be displayed via the debug plugin extension.
-         * @param perfEvent
+         * @param perfEvent - The performance event object
          */
         perfEvent?: (perfEvent: IPerfEvent) => void;
         /**
@@ -2845,17 +2819,14 @@ declare namespace ApplicationInsights {
     interface ITraceTelemetry extends IPartC {
         /**
          * @description A message string
-         * @type {string}
          */
         message: string;
         /**
          * @description Severity level of the logging message used for filtering in the portal
-         * @type {SeverityLevel}
          */
         severityLevel?: SeverityLevel;
         /**
          * @description custom defiend iKey
-         * @type {SeverityLevel}
          */
         iKey?: string;
     }