@microsoft/applicationinsights-core-js 2.7.1-nightly.202110-03 → 2.7.1-nightly.202110-07

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

@@ -385,7 +385,7 @@
             },
             {
               "kind": "Content",
-              "text": "{\n    BrowserDoesNotSupportLocalStorage: number;\n    BrowserCannotReadLocalStorage: number;\n    BrowserCannotReadSessionStorage: number;\n    BrowserCannotWriteLocalStorage: number;\n    BrowserCannotWriteSessionStorage: number;\n    BrowserFailedRemovalFromLocalStorage: number;\n    BrowserFailedRemovalFromSessionStorage: number;\n    CannotSendEmptyTelemetry: number;\n    ClientPerformanceMathError: number;\n    ErrorParsingAISessionCookie: number;\n    ErrorPVCalc: number;\n    ExceptionWhileLoggingError: number;\n    FailedAddingTelemetryToBuffer: number;\n    FailedMonitorAjaxAbort: number;\n    FailedMonitorAjaxDur: number;\n    FailedMonitorAjaxOpen: number;\n    FailedMonitorAjaxRSC: number;\n    FailedMonitorAjaxSend: number;\n    FailedMonitorAjaxGetCorrelationHeader: number;\n    FailedToAddHandlerForOnBeforeUnload: number;\n    FailedToSendQueuedTelemetry: number;\n    FailedToReportDataLoss: number;\n    FlushFailed: number;\n    MessageLimitPerPVExceeded: number;\n    MissingRequiredFieldSpecification: number;\n    NavigationTimingNotSupported: number;\n    OnError: number;\n    SessionRenewalDateIsZero: number;\n    SenderNotInitialized: number;\n    StartTrackEventFailed: number;\n    StopTrackEventFailed: number;\n    StartTrackFailed: number;\n    StopTrackFailed: number;\n    TelemetrySampledAndNotSent: number;\n    TrackEventFailed: number;\n    TrackExceptionFailed: number;\n    TrackMetricFailed: number;\n    TrackPVFailed: number;\n    TrackPVFailedCalc: number;\n    TrackTraceFailed: number;\n    TransmissionFailed: number;\n    FailedToSetStorageBuffer: number;\n    FailedToRestoreStorageBuffer: number;\n    InvalidBackendResponse: number;\n    FailedToFixDepricatedValues: number;\n    InvalidDurationValue: number;\n    TelemetryEnvelopeInvalid: number;\n    CreateEnvelopeError: number;\n    CannotSerializeObject: number;\n    CannotSerializeObjectNonSerializable: number;\n    CircularReferenceDetected: number;\n    ClearAuthContextFailed: number;\n    ExceptionTruncated: number;\n    IllegalCharsInName: number;\n    ItemNotInArray: number;\n    MaxAjaxPerPVExceeded: number;\n    MessageTruncated: number;\n    NameTooLong: number;\n    SampleRateOutOfRange: number;\n    SetAuthContextFailed: number;\n    SetAuthContextFailedAccountName: number;\n    StringValueTooLong: number;\n    StartCalledMoreThanOnce: number;\n    StopCalledWithoutStart: number;\n    TelemetryInitializerFailed: number;\n    TrackArgumentsNotSpecified: number;\n    UrlTooLong: number;\n    SessionStorageBufferFull: number;\n    CannotAccessCookie: number;\n    IdTooLong: number;\n    InvalidEvent: number;\n    FailedMonitorAjaxSetRequestHeader: number;\n    SendBrowserInfoOnUserInit: number;\n    PluginException: number;\n    NotificationException: number;\n    SnippetScriptLoadFailure: number;\n    InvalidInstrumentationKey: number;\n    CannotParseAiBlobValue: number;\n    InvalidContentBlob: number;\n    TrackPageActionEventFailed: number;\n    FailedAddingCustomDefinedRequestContext: number;\n}"
+              "text": "{\n    BrowserDoesNotSupportLocalStorage: number;\n    BrowserCannotReadLocalStorage: number;\n    BrowserCannotReadSessionStorage: number;\n    BrowserCannotWriteLocalStorage: number;\n    BrowserCannotWriteSessionStorage: number;\n    BrowserFailedRemovalFromLocalStorage: number;\n    BrowserFailedRemovalFromSessionStorage: number;\n    CannotSendEmptyTelemetry: number;\n    ClientPerformanceMathError: number;\n    ErrorParsingAISessionCookie: number;\n    ErrorPVCalc: number;\n    ExceptionWhileLoggingError: number;\n    FailedAddingTelemetryToBuffer: number;\n    FailedMonitorAjaxAbort: number;\n    FailedMonitorAjaxDur: number;\n    FailedMonitorAjaxOpen: number;\n    FailedMonitorAjaxRSC: number;\n    FailedMonitorAjaxSend: number;\n    FailedMonitorAjaxGetCorrelationHeader: number;\n    FailedToAddHandlerForOnBeforeUnload: number;\n    FailedToSendQueuedTelemetry: number;\n    FailedToReportDataLoss: number;\n    FlushFailed: number;\n    MessageLimitPerPVExceeded: number;\n    MissingRequiredFieldSpecification: number;\n    NavigationTimingNotSupported: number;\n    OnError: number;\n    SessionRenewalDateIsZero: number;\n    SenderNotInitialized: number;\n    StartTrackEventFailed: number;\n    StopTrackEventFailed: number;\n    StartTrackFailed: number;\n    StopTrackFailed: number;\n    TelemetrySampledAndNotSent: number;\n    TrackEventFailed: number;\n    TrackExceptionFailed: number;\n    TrackMetricFailed: number;\n    TrackPVFailed: number;\n    TrackPVFailedCalc: number;\n    TrackTraceFailed: number;\n    TransmissionFailed: number;\n    FailedToSetStorageBuffer: number;\n    FailedToRestoreStorageBuffer: number;\n    InvalidBackendResponse: number;\n    FailedToFixDepricatedValues: number;\n    InvalidDurationValue: number;\n    TelemetryEnvelopeInvalid: number;\n    CreateEnvelopeError: number;\n    CannotSerializeObject: number;\n    CannotSerializeObjectNonSerializable: number;\n    CircularReferenceDetected: number;\n    ClearAuthContextFailed: number;\n    ExceptionTruncated: number;\n    IllegalCharsInName: number;\n    ItemNotInArray: number;\n    MaxAjaxPerPVExceeded: number;\n    MessageTruncated: number;\n    NameTooLong: number;\n    SampleRateOutOfRange: number;\n    SetAuthContextFailed: number;\n    SetAuthContextFailedAccountName: number;\n    StringValueTooLong: number;\n    StartCalledMoreThanOnce: number;\n    StopCalledWithoutStart: number;\n    TelemetryInitializerFailed: number;\n    TrackArgumentsNotSpecified: number;\n    UrlTooLong: number;\n    SessionStorageBufferFull: number;\n    CannotAccessCookie: number;\n    IdTooLong: number;\n    InvalidEvent: number;\n    FailedMonitorAjaxSetRequestHeader: number;\n    SendBrowserInfoOnUserInit: number;\n    PluginException: number;\n    NotificationException: number;\n    SnippetScriptLoadFailure: number;\n    InvalidInstrumentationKey: number;\n    CannotParseAiBlobValue: number;\n    InvalidContentBlob: number;\n    TrackPageActionEventFailed: number;\n    FailedAddingCustomDefinedRequestContext: number;\n    InMemoryStorageBufferFull: number;\n}"
             }
           ],
           "releaseTag": "Public",
@@ -514,6 +514,253 @@
           ],
           "name": "addEventHandler"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!addEventListeners:function(1)",
+          "docComment": "/**\n * Bind the listener to the array of events\n *\n * @param events - An string array of event names to bind the listener to\n *\n * @param listener - The event callback to call when the event is triggered\n *\n * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be.\n *\n * @returns true - when at least one of the events was registered otherwise false\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function addEventListeners(events: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": ", listener: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", excludeEvents?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 7,
+            "endIndex": 8
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "events",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "parameterName": "listener",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            },
+            {
+              "parameterName": "excludeEvents",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              }
+            }
+          ],
+          "name": "addEventListeners"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!addPageHideEventListener:function(1)",
+          "docComment": "/**\n * Listen to the pagehide and visibility changing to 'hidden' events\n *\n * @param listener - The event callback to call when a page hide event is triggered\n *\n * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be. Suggestion: pass as true if you are also calling addPageUnloadEventListener as that also hooks pagehide\n *\n * @returns true - when at least one of the events was registered otherwise false\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function addPageHideEventListener(listener: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", excludeEvents?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "listener",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "parameterName": "excludeEvents",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "addPageHideEventListener"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!addPageShowEventListener:function(1)",
+          "docComment": "/**\n * Listen to the pageshow and visibility changing to 'visible' events\n *\n * @param listener - The event callback to call when a page is show event is triggered\n *\n * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be.\n *\n * @returns true - when at least one of the events was registered otherwise false\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function addPageShowEventListener(listener: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", excludeEvents?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "listener",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "parameterName": "excludeEvents",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "addPageShowEventListener"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/applicationinsights-core-js!addPageUnloadEventListener:function(1)",
+          "docComment": "/**\n * Listen to the 'beforeunload', 'unload' and 'pagehide' events which indicates a page unload is occurring, this does NOT listen to the 'visibilitychange' event as while it does indicate that the page is being hidden it does not *necessarily* mean that the page is being completely unloaded, it can mean that the user is just navigating to a different Tab and may come back (without unloading the page). As such you may also need to listen to the 'addPageHideEventListener' and 'addPageShowEventListener' events.\n *\n * @param listener - The event callback to call when a page unload event is triggered\n *\n * @param excludeEvents - [Optional] An array of events that should not be hooked, unless no other events can be.\n *\n * @returns true - when at least one of the events was registered otherwise false\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function addPageUnloadEventListener(listener: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", excludeEvents?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "listener",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "parameterName": "excludeEvents",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "addPageUnloadEventListener"
+        },
         {
           "kind": "Class",
           "canonicalReference": "@microsoft/applicationinsights-core-js!AppInsightsCore:class",
@@ -5560,6 +5807,58 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#disablePageShowEvents:member",
+              "docComment": "/**\n * [Optional] An array of page show events that you would like to be ignored, special note there must be at lease one valid show event hooked, if you list all or the runtime environment only supports a listed (disabled) event it will STILL be hooked, if required by the SDK. Page Show events include \"pageshow\" and \"visibilitychange\" (with 'visible' state)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "disablePageShowEvents?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "disablePageShowEvents",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#disablePageUnloadEvents:member",
+              "docComment": "/**\n * [Optional] An array of the page unload events that you would like to be ignored, special note there must be at least one valid unload event hooked, if you list all or the runtime environment only supports a listed \"disabled\" event it will still be hooked, if required by the SDK. Unload events include \"beforeunload\", \"unload\", \"visibilitychange\" (with 'hidden' state) and \"pagehide\"\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "disablePageUnloadEvents?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "disablePageUnloadEvents",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@microsoft/applicationinsights-core-js!IConfiguration#enableDebugExceptions:member",

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

@@ -14,6 +14,18 @@ import { strShimUndefined as strUndefined } from '@microsoft/applicationinsights
 // @public
 export function addEventHandler(eventName: string, callback: any): boolean;
 
+// @public
+export function addEventListeners(events: string[], listener: any, excludeEvents?: string[]): boolean;
+
+// @public
+export function addPageHideEventListener(listener: any, excludeEvents?: string[]): boolean;
+
+// @public
+export function addPageShowEventListener(listener: any, excludeEvents?: string[]): boolean;
+
+// @public
+export function addPageUnloadEventListener(listener: any, excludeEvents?: string[]): boolean;
+
 // @public (undocumented)
 export class AppInsightsCore extends BaseCore implements IAppInsightsCore {
     constructor();
@@ -276,6 +288,8 @@ export interface IConfiguration {
     diagnosticLogInterval?: number;
     disableCookiesUsage?: boolean;
     disableInstrumentationKeyValidation?: boolean;
+    disablePageShowEvents?: string[];
+    disablePageUnloadEvents?: string[];
     enableDebugExceptions?: boolean;
     enablePerfMgr?: boolean;
     endpointUrl?: string;
@@ -556,6 +570,7 @@ export const _InternalMessageId: {
     InvalidContentBlob: number;
     TrackPageActionEventFailed: number;
     FailedAddingCustomDefinedRequestContext: number;
+    InMemoryStorageBufferFull: number;
 };
 
 // @public (undocumented)

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

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 2.7.1-nightly.202110-03
+ * Microsoft Application Insights Core Javascript SDK, 2.7.1-nightly.202110-07
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -22,6 +22,44 @@ declare namespace ApplicationInsights {
      */
     function addEventHandler(eventName: string, callback: any): boolean;
 
+    /**
+     * Bind the listener to the array of events
+     * @param events An string array of event names to bind the listener to
+     * @param listener The event callback to call when the event is triggered
+     * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be.
+     * @returns true - when at least one of the events was registered otherwise false
+     */
+    function addEventListeners(events: string[], listener: any, excludeEvents?: string[]): boolean;
+
+    /**
+     * Listen to the pagehide and visibility changing to 'hidden' events
+     * @param listener - The event callback to call when a page hide event is triggered
+     * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be.
+     * Suggestion: pass as true if you are also calling addPageUnloadEventListener as that also hooks pagehide
+     * @returns true - when at least one of the events was registered otherwise false
+     */
+    function addPageHideEventListener(listener: any, excludeEvents?: string[]): boolean;
+
+    /**
+     * Listen to the pageshow and visibility changing to 'visible' events
+     * @param listener - The event callback to call when a page is show event is triggered
+     * @param excludeEvents - [Optional] An array of events that should not be hooked (if possible), unless no other events can be.
+     * @returns true - when at least one of the events was registered otherwise false
+     */
+    function addPageShowEventListener(listener: any, excludeEvents?: string[]): boolean;
+
+    /**
+     * Listen to the 'beforeunload', 'unload' and 'pagehide' events which indicates a page unload is occurring,
+     * this does NOT listen to the 'visibilitychange' event as while it does indicate that the page is being hidden
+     * it does not *necessarily* mean that the page is being completely unloaded, it can mean that the user is
+     * just navigating to a different Tab and may come back (without unloading the page). As such you may also
+     * need to listen to the 'addPageHideEventListener' and 'addPageShowEventListener' events.
+     * @param listener - The event callback to call when a page unload event is triggered
+     * @param excludeEvents - [Optional] An array of events that should not be hooked, unless no other events can be.
+     * @returns true - when at least one of the events was registered otherwise false
+     */
+    function addPageUnloadEventListener(listener: any, excludeEvents?: string[]): boolean;
+
     class AppInsightsCore extends BaseCore implements IAppInsightsCore {
         constructor();
         initialize(config: IConfiguration, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
@@ -678,6 +716,18 @@ declare namespace ApplicationInsights {
          * cookieDomain and disableCookiesUsage values.
          */
         cookieCfg?: ICookieMgrConfig;
+        /**
+         * [Optional] An array of the page unload events that you would like to be ignored, special note there must be at least one valid unload
+         * event hooked, if you list all or the runtime environment only supports a listed "disabled" event it will still be hooked, if required by the SDK.
+         * Unload events include "beforeunload", "unload", "visibilitychange" (with 'hidden' state) and "pagehide"
+         */
+        disablePageUnloadEvents?: string[];
+        /**
+         * [Optional] An array of page show events that you would like to be ignored, special note there must be at lease one valid show event
+         * hooked, if you list all or the runtime environment only supports a listed (disabled) event it will STILL be hooked, if required by the SDK.
+         * Page Show events include "pageshow" and "visibilitychange" (with 'visible' state)
+         */
+        disablePageShowEvents?: string[];
     }
 
     interface ICookieMgr {
@@ -1320,6 +1370,7 @@ declare namespace ApplicationInsights {
         InvalidContentBlob: number;
         TrackPageActionEventFailed: number;
         FailedAddingCustomDefinedRequestContext: number;
+        InMemoryStorageBufferFull: number;
     };
 
     type _InternalMessageId = number | typeof _InternalMessageId;

package/dist/applicationinsights-core-js.js

@@ -1,5 +1,5 @@
 /*!
- * Application Insights JavaScript SDK - Core, 2.7.1-nightly.202110-03
+ * Application Insights JavaScript SDK - Core, 2.7.1-nightly.202110-07
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 (function (global, factory) {
@@ -422,7 +422,8 @@
         CannotParseAiBlobValue: 101,
         InvalidContentBlob: 102,
         TrackPageActionEventFailed: 103,
-        FailedAddingCustomDefinedRequestContext: 104
+        FailedAddingCustomDefinedRequestContext: 104,
+        InMemoryStorageBufferFull: 105
     };
 
     var strOnPrefix = "on";
@@ -2299,6 +2300,9 @@
         return value;
     }
 
+    var strVisibilityChangeEvt = "visibilitychange";
+    var strPageHide = "pagehide";
+    var strPageShow = "pageshow";
     var _cookieMgrs = null;
     var _canUseCookies;
     var Undefined = strShimUndefined;
@@ -2315,6 +2319,67 @@
         }
         return result;
     }
+    function addEventListeners(events, listener, excludeEvents) {
+        var added = false;
+        if (listener && events && isArray(events)) {
+            var excluded_1 = [];
+            arrForEach(events, function (name) {
+                if (isString(name)) {
+                    if (!excludeEvents || arrIndexOf(excludeEvents, name) === -1) {
+                        added = addEventHandler(name, listener) || added;
+                    }
+                    else {
+                        excluded_1.push(name);
+                    }
+                }
+            });
+            if (!added && excluded_1.length > 0) {
+                added = addEventListeners(excluded_1, listener);
+            }
+        }
+        return added;
+    }
+    function addPageUnloadEventListener(listener, excludeEvents) {
+        return addEventListeners(["beforeunload", "unload", "pagehide"], listener, excludeEvents);
+    }
+    function addPageHideEventListener(listener, excludeEvents) {
+        function _handlePageVisibility(evt) {
+            var doc = getDocument();
+            if (listener && doc && doc.visibilityState === 'hidden') {
+                listener(evt);
+            }
+        }
+        var pageUnloadAdded = false;
+        if (!excludeEvents || arrIndexOf(excludeEvents, strPageHide) === -1) {
+            pageUnloadAdded = addEventHandler(strPageHide, listener);
+        }
+        if (!excludeEvents || arrIndexOf(excludeEvents, strVisibilityChangeEvt) === -1) {
+            pageUnloadAdded = addEventHandler(strVisibilityChangeEvt, _handlePageVisibility) || pageUnloadAdded;
+        }
+        if (!pageUnloadAdded && excludeEvents) {
+            pageUnloadAdded = addPageHideEventListener(listener);
+        }
+        return pageUnloadAdded;
+    }
+    function addPageShowEventListener(listener, excludeEvents) {
+        function _handlePageVisibility(evt) {
+            var doc = getDocument();
+            if (listener && doc && doc.visibilityState === 'visible') {
+                listener(evt);
+            }
+        }
+        var pageShowAdded = false;
+        if (!excludeEvents || arrIndexOf(excludeEvents, strPageShow) === -1) {
+            pageShowAdded = addEventHandler(strPageShow, listener);
+        }
+        if (!excludeEvents || arrIndexOf(excludeEvents, strVisibilityChangeEvt) === -1) {
+            pageShowAdded = addEventHandler(strVisibilityChangeEvt, _handlePageVisibility) || pageShowAdded;
+        }
+        if (!pageShowAdded && excludeEvents) {
+            pageShowAdded = addPageShowEventListener(listener);
+        }
+        return pageShowAdded;
+    }
     function newGuid() {
         function randomHexDigit() {
             return randomValue(15);
@@ -2649,6 +2714,10 @@
     exports._InternalMessageId = _InternalMessageId;
     exports._legacyCookieMgr = _legacyCookieMgr;
     exports.addEventHandler = addEventHandler;
+    exports.addEventListeners = addEventListeners;
+    exports.addPageHideEventListener = addPageHideEventListener;
+    exports.addPageShowEventListener = addPageShowEventListener;
+    exports.addPageUnloadEventListener = addPageUnloadEventListener;
     exports.areCookiesSupported = areCookiesSupported;
     exports.arrForEach = arrForEach;
     exports.arrIndexOf = arrIndexOf;