@microsoft/applicationinsights-common 2.8.0-beta.2203-04 → 2.8.0-beta.2203-07

package/dist/applicationinsights-common.js

@@ -1,5 +1,5 @@
 /*!
- * Application Insights JavaScript SDK - Common, 2.8.0-beta.2203-04
+ * Application Insights JavaScript SDK - Common, 2.8.0-beta.2203-07
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 (function (global, factory) {
@@ -94,6 +94,247 @@
         d[strShimPrototype] = b === null ? objCreateFn(b) : (__[strShimPrototype] = b[strShimPrototype], new __());
     }
 
+    /*!
+     * Microsoft Dynamic Proto Utility, 1.1.4
+     * Copyright (c) Microsoft and contributors. All rights reserved.
+     */
+    var Constructor = 'constructor';
+    var Prototype = 'prototype';
+    var strFunction = 'function';
+    var DynInstFuncTable = '_dynInstFuncs';
+    var DynProxyTag = '_isDynProxy';
+    var DynClassName = '_dynClass';
+    var DynClassNamePrefix = '_dynCls$';
+    var DynInstChkTag = '_dynInstChk';
+    var DynAllowInstChkTag = DynInstChkTag;
+    var DynProtoDefaultOptions = '_dfOpts';
+    var UnknownValue = '_unknown_';
+    var str__Proto = "__proto__";
+    var strUseBaseInst = 'useBaseInst';
+    var strSetInstFuncs = 'setInstFuncs';
+    var Obj = Object;
+    var _objGetPrototypeOf = Obj["getPrototypeOf"];
+    var _dynamicNames = 0;
+    function _hasOwnProperty(obj, prop) {
+        return obj && Obj[Prototype].hasOwnProperty.call(obj, prop);
+    }
+    function _isObjectOrArrayPrototype(target) {
+        return target && (target === Obj[Prototype] || target === Array[Prototype]);
+    }
+    function _isObjectArrayOrFunctionPrototype(target) {
+        return _isObjectOrArrayPrototype(target) || target === Function[Prototype];
+    }
+    function _getObjProto(target) {
+        if (target) {
+            if (_objGetPrototypeOf) {
+                return _objGetPrototypeOf(target);
+            }
+            var newProto = target[str__Proto] || target[Prototype] || (target[Constructor] ? target[Constructor][Prototype] : null);
+            if (newProto) {
+                return newProto;
+            }
+        }
+        return null;
+    }
+    function _forEachProp(target, func) {
+        var props = [];
+        var getOwnProps = Obj["getOwnPropertyNames"];
+        if (getOwnProps) {
+            props = getOwnProps(target);
+        }
+        else {
+            for (var name_1 in target) {
+                if (typeof name_1 === "string" && _hasOwnProperty(target, name_1)) {
+                    props.push(name_1);
+                }
+            }
+        }
+        if (props && props.length > 0) {
+            for (var lp = 0; lp < props.length; lp++) {
+                func(props[lp]);
+            }
+        }
+    }
+    function _isDynamicCandidate(target, funcName, skipOwn) {
+        return (funcName !== Constructor && typeof target[funcName] === strFunction && (skipOwn || _hasOwnProperty(target, funcName)));
+    }
+    function _throwTypeError(message) {
+        throw new TypeError("DynamicProto: " + message);
+    }
+    function _getInstanceFuncs(thisTarget) {
+        var instFuncs = {};
+        _forEachProp(thisTarget, function (name) {
+            if (!instFuncs[name] && _isDynamicCandidate(thisTarget, name, false)) {
+                instFuncs[name] = thisTarget[name];
+            }
+        });
+        return instFuncs;
+    }
+    function _hasVisited(values, value) {
+        for (var lp = values.length - 1; lp >= 0; lp--) {
+            if (values[lp] === value) {
+                return true;
+            }
+        }
+        return false;
+    }
+    function _getBaseFuncs(classProto, thisTarget, instFuncs, useBaseInst) {
+        function _instFuncProxy(target, funcHost, funcName) {
+            var theFunc = funcHost[funcName];
+            if (theFunc[DynProxyTag] && useBaseInst) {
+                var instFuncTable = target[DynInstFuncTable] || {};
+                if (instFuncTable[DynAllowInstChkTag] !== false) {
+                    theFunc = (instFuncTable[funcHost[DynClassName]] || {})[funcName] || theFunc;
+                }
+            }
+            return function () {
+                return theFunc.apply(target, arguments);
+            };
+        }
+        var baseFuncs = {};
+        _forEachProp(instFuncs, function (name) {
+            baseFuncs[name] = _instFuncProxy(thisTarget, instFuncs, name);
+        });
+        var baseProto = _getObjProto(classProto);
+        var visited = [];
+        while (baseProto && !_isObjectArrayOrFunctionPrototype(baseProto) && !_hasVisited(visited, baseProto)) {
+            _forEachProp(baseProto, function (name) {
+                if (!baseFuncs[name] && _isDynamicCandidate(baseProto, name, !_objGetPrototypeOf)) {
+                    baseFuncs[name] = _instFuncProxy(thisTarget, baseProto, name);
+                }
+            });
+            visited.push(baseProto);
+            baseProto = _getObjProto(baseProto);
+        }
+        return baseFuncs;
+    }
+    function _getInstFunc(target, funcName, proto, currentDynProtoProxy) {
+        var instFunc = null;
+        if (target && _hasOwnProperty(proto, DynClassName)) {
+            var instFuncTable = target[DynInstFuncTable] || {};
+            instFunc = (instFuncTable[proto[DynClassName]] || {})[funcName];
+            if (!instFunc) {
+                _throwTypeError("Missing [" + funcName + "] " + strFunction);
+            }
+            if (!instFunc[DynInstChkTag] && instFuncTable[DynAllowInstChkTag] !== false) {
+                var canAddInst = !_hasOwnProperty(target, funcName);
+                var objProto = _getObjProto(target);
+                var visited = [];
+                while (canAddInst && objProto && !_isObjectArrayOrFunctionPrototype(objProto) && !_hasVisited(visited, objProto)) {
+                    var protoFunc = objProto[funcName];
+                    if (protoFunc) {
+                        canAddInst = (protoFunc === currentDynProtoProxy);
+                        break;
+                    }
+                    visited.push(objProto);
+                    objProto = _getObjProto(objProto);
+                }
+                try {
+                    if (canAddInst) {
+                        target[funcName] = instFunc;
+                    }
+                    instFunc[DynInstChkTag] = 1;
+                }
+                catch (e) {
+                    instFuncTable[DynAllowInstChkTag] = false;
+                }
+            }
+        }
+        return instFunc;
+    }
+    function _getProtoFunc(funcName, proto, currentDynProtoProxy) {
+        var protoFunc = proto[funcName];
+        if (protoFunc === currentDynProtoProxy) {
+            protoFunc = _getObjProto(proto)[funcName];
+        }
+        if (typeof protoFunc !== strFunction) {
+            _throwTypeError("[" + funcName + "] is not a " + strFunction);
+        }
+        return protoFunc;
+    }
+    function _populatePrototype(proto, className, target, baseInstFuncs, setInstanceFunc) {
+        function _createDynamicPrototype(proto, funcName) {
+            var dynProtoProxy = function () {
+                var instFunc = _getInstFunc(this, funcName, proto, dynProtoProxy) || _getProtoFunc(funcName, proto, dynProtoProxy);
+                return instFunc.apply(this, arguments);
+            };
+            dynProtoProxy[DynProxyTag] = 1;
+            return dynProtoProxy;
+        }
+        if (!_isObjectOrArrayPrototype(proto)) {
+            var instFuncTable = target[DynInstFuncTable] = target[DynInstFuncTable] || {};
+            var instFuncs_1 = instFuncTable[className] = (instFuncTable[className] || {});
+            if (instFuncTable[DynAllowInstChkTag] !== false) {
+                instFuncTable[DynAllowInstChkTag] = !!setInstanceFunc;
+            }
+            _forEachProp(target, function (name) {
+                if (_isDynamicCandidate(target, name, false) && target[name] !== baseInstFuncs[name]) {
+                    instFuncs_1[name] = target[name];
+                    delete target[name];
+                    if (!_hasOwnProperty(proto, name) || (proto[name] && !proto[name][DynProxyTag])) {
+                        proto[name] = _createDynamicPrototype(proto, name);
+                    }
+                }
+            });
+        }
+    }
+    function _checkPrototype(classProto, thisTarget) {
+        if (_objGetPrototypeOf) {
+            var visited = [];
+            var thisProto = _getObjProto(thisTarget);
+            while (thisProto && !_isObjectArrayOrFunctionPrototype(thisProto) && !_hasVisited(visited, thisProto)) {
+                if (thisProto === classProto) {
+                    return true;
+                }
+                visited.push(thisProto);
+                thisProto = _getObjProto(thisProto);
+            }
+        }
+        return false;
+    }
+    function _getObjName(target, unknownValue) {
+        if (_hasOwnProperty(target, Prototype)) {
+            return target.name || unknownValue || UnknownValue;
+        }
+        return (((target || {})[Constructor]) || {}).name || unknownValue || UnknownValue;
+    }
+    function dynamicProto(theClass, target, delegateFunc, options) {
+        if (!_hasOwnProperty(theClass, Prototype)) {
+            _throwTypeError("theClass is an invalid class definition.");
+        }
+        var classProto = theClass[Prototype];
+        if (!_checkPrototype(classProto, target)) {
+            _throwTypeError("[" + _getObjName(theClass) + "] is not in class hierarchy of [" + _getObjName(target) + "]");
+        }
+        var className = null;
+        if (_hasOwnProperty(classProto, DynClassName)) {
+            className = classProto[DynClassName];
+        }
+        else {
+            className = DynClassNamePrefix + _getObjName(theClass, "_") + "$" + _dynamicNames;
+            _dynamicNames++;
+            classProto[DynClassName] = className;
+        }
+        var perfOptions = dynamicProto[DynProtoDefaultOptions];
+        var useBaseInst = !!perfOptions[strUseBaseInst];
+        if (useBaseInst && options && options[strUseBaseInst] !== undefined) {
+            useBaseInst = !!options[strUseBaseInst];
+        }
+        var instFuncs = _getInstanceFuncs(target);
+        var baseFuncs = _getBaseFuncs(classProto, target, instFuncs, useBaseInst);
+        delegateFunc(target, baseFuncs);
+        var setInstanceFunc = !!_objGetPrototypeOf && !!perfOptions[strSetInstFuncs];
+        if (setInstanceFunc && options) {
+            setInstanceFunc = !!options[strSetInstFuncs];
+        }
+        _populatePrototype(classProto, className, target, instFuncs, setInstanceFunc !== false);
+    }
+    var perfDefaults = {
+        setInstFuncs: true,
+        useBaseInst: true
+    };
+    dynamicProto[DynProtoDefaultOptions] = perfDefaults;
+
     var strEmpty$1 = "";
 
     var strToISOString = "toISOString";
@@ -435,6 +676,7 @@
     var strDocumentMode = "documentMode";
     var strNavigator = "navigator";
     var strLocation = "location";
+    var strConsole = "console";
     var strPerformance = "performance";
     var strJSON = "JSON";
     var strCrypto = "crypto";
@@ -494,6 +736,12 @@
         }
         return getGlobalInst(strLocation);
     }
+    function getConsole() {
+        if (typeof console !== strShimUndefined) {
+            return console;
+        }
+        return getGlobalInst(strConsole);
+    }
     function getPerformance() {
         return getGlobalInst(strPerformance);
     }
@@ -558,6 +806,175 @@
         return _beaconsSupported;
     }
 
+    var _aiNamespace = null;
+    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;
+    }
+
+    var AiNonUserActionablePrefix = "AI (Internal): ";
+    var AiUserActionablePrefix = "AI: ";
+    var AIInternalMessagePrefix = "AITR_";
+    var strErrorToConsole = "errorToConsole";
+    var strWarnToConsole = "warnToConsole";
+    function _sanitizeDiagnosticText(text) {
+        if (text) {
+            return "\"" + text.replace(/\"/g, strEmpty$1) + "\"";
+        }
+        return strEmpty$1;
+    }
+    function _logToConsole(func, message) {
+        var theConsole = getConsole();
+        if (!!theConsole) {
+            var logFunc = "log";
+            if (theConsole[func]) {
+                logFunc = func;
+            }
+            if (isFunction(theConsole[logFunc])) {
+                theConsole[logFunc](message);
+            }
+        }
+    }
+    var _InternalLogMessage = /** @class */ (function () {
+        function _InternalLogMessage(msgId, msg, isUserAct, properties) {
+            if (isUserAct === void 0) { isUserAct = false; }
+            var _self = this;
+            _self.messageId = msgId;
+            _self.message =
+                (isUserAct ? AiUserActionablePrefix : AiNonUserActionablePrefix) +
+                    msgId;
+            var strProps = strEmpty$1;
+            if (hasJSON()) {
+                strProps = getJSON().stringify(properties);
+            }
+            var diagnosticText = (msg ? " message:" + _sanitizeDiagnosticText(msg) : strEmpty$1) +
+                (properties ? " props:" + _sanitizeDiagnosticText(strProps) : strEmpty$1);
+            _self.message += diagnosticText;
+        }
+        _InternalLogMessage.dataType = "MessageData";
+        return _InternalLogMessage;
+    }());
+    var DiagnosticLogger = /** @class */ (function () {
+        function DiagnosticLogger(config) {
+            this.identifier = "DiagnosticLogger";
+            this.queue = [];
+            var _messageCount = 0;
+            var _messageLogged = {};
+            dynamicProto(DiagnosticLogger, this, function (_self) {
+                if (isNullOrUndefined(config)) {
+                    config = {};
+                }
+                _self.consoleLoggingLevel = function () { return _getConfigValue("loggingLevelConsole", 0); };
+                _self.telemetryLoggingLevel = function () { return _getConfigValue("loggingLevelTelemetry", 1); };
+                _self.maxInternalMessageLimit = function () { return _getConfigValue("maxMessageLimit", 25); };
+                _self.enableDebugExceptions = function () { return _getConfigValue("enableDebugExceptions", false); };
+                _self.throwInternal = function (severity, msgId, msg, properties, isUserAct) {
+                    if (isUserAct === void 0) { isUserAct = false; }
+                    var message = new _InternalLogMessage(msgId, msg, isUserAct, properties);
+                    if (_self.enableDebugExceptions()) {
+                        throw message;
+                    }
+                    else {
+                        var logFunc = severity === 1  ? strErrorToConsole : strWarnToConsole;
+                        if (!isUndefined(message.message)) {
+                            var logLevel = _self.consoleLoggingLevel();
+                            if (isUserAct) {
+                                var messageKey = +message.messageId;
+                                if (!_messageLogged[messageKey] && logLevel >= severity) {
+                                    _self[logFunc](message.message);
+                                    _messageLogged[messageKey] = true;
+                                }
+                            }
+                            else {
+                                if (logLevel >= severity) {
+                                    _self[logFunc](message.message);
+                                }
+                            }
+                            _self.logInternalMessage(severity, message);
+                        }
+                        else {
+                            _debugExtMsg("throw" + (severity === 1  ? "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;
+                    _messageLogged = {};
+                };
+                _self.logInternalMessage = function (severity, message) {
+                    if (_areInternalMessagesThrottled()) {
+                        return;
+                    }
+                    var logMessage = true;
+                    var messageKey = AIInternalMessagePrefix + message.messageId;
+                    if (_messageLogged[messageKey]) {
+                        logMessage = false;
+                    }
+                    else {
+                        _messageLogged[messageKey] = true;
+                    }
+                    if (logMessage) {
+                        if (severity <= _self.telemetryLoggingLevel()) {
+                            _self.queue.push(message);
+                            _messageCount++;
+                            _debugExtMsg((severity === 1  ? "error" : "warn"), message);
+                        }
+                        if (_messageCount === _self.maxInternalMessageLimit()) {
+                            var throttleLimitMessage = "Internal events throttle limit per PageView reached for this app.";
+                            var throttleMessage = new _InternalLogMessage(23 , throttleLimitMessage, false);
+                            _self.queue.push(throttleMessage);
+                            if (severity === 1 ) {
+                                _self.errorToConsole(throttleLimitMessage);
+                            }
+                            else {
+                                _self.warnToConsole(throttleLimitMessage);
+                            }
+                        }
+                    }
+                };
+                function _getConfigValue(name, defValue) {
+                    var value = config[name];
+                    if (!isNullOrUndefined(value)) {
+                        return value;
+                    }
+                    return defValue;
+                }
+                function _areInternalMessagesThrottled() {
+                    return _messageCount >= _self.maxInternalMessageLimit();
+                }
+                function _debugExtMsg(name, data) {
+                    var dbgExt = getDebugExt(config);
+                    if (dbgExt && dbgExt.diagLog) {
+                        dbgExt.diagLog(name, data);
+                    }
+                }
+            });
+        }
+        return DiagnosticLogger;
+    }());
+    function _throwInternal(logger, severity, msgId, msg, properties, isUserAct) {
+        if (isUserAct === void 0) { isUserAct = false; }
+        (logger || new DiagnosticLogger()).throwInternal(severity, msgId, msg, properties, isUserAct);
+    }
+
     var UInt32Mask = 0x100000000;
     var MaxUInt32 = 0xffffffff;
     var _mwcSeeded = false;
@@ -859,7 +1276,7 @@
                 _supportsCookies = doc[strCookie] !== undefined;
             }
             catch (e) {
-                logger && logger.throwInternal(2 , 68 , "Cannot access document.cookie - " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , 68 , "Cannot access document.cookie - " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return _supportsCookies;
@@ -953,12 +1370,12 @@
         }
         return name;
     }
-    function _getEvtNamespace(eventName, namespaces) {
-        if (namespaces) {
+    function _getEvtNamespace(eventName, evtNamespace) {
+        if (evtNamespace) {
             var theNamespace_1 = "";
-            if (isArray(namespaces)) {
+            if (isArray(evtNamespace)) {
                 theNamespace_1 = "";
-                arrForEach(namespaces, function (name) {
+                arrForEach(evtNamespace, function (name) {
                     name = _normalizeNamespace(name);
                     if (name) {
                         if (name[0] !== ".") {
@@ -969,7 +1386,7 @@
                 });
             }
             else {
-                theNamespace_1 = _normalizeNamespace(namespaces);
+                theNamespace_1 = _normalizeNamespace(evtNamespace);
             }
             if (theNamespace_1) {
                 if (theNamespace_1[0] !== ".") {
@@ -1283,7 +1700,7 @@
             name = strTrim(name.toString());
             if (name.length > 150 ) {
                 nameTrunc = name.substring(0, 150 );
-                logger && logger.throwInternal(2 , _InternalMessageId.NameTooLong, "name is too long.  It has been truncated to " + 150  + " characters.", { name: name }, true);
+                _throwInternal(logger, 2 , _InternalMessageId.NameTooLong, "name is too long.  It has been truncated to " + 150  + " characters.", { name: name }, true);
             }
         }
         return nameTrunc || name;
@@ -1296,7 +1713,7 @@
             value = strTrim(value);
             if (value.toString().length > maxLength) {
                 valueTrunc = value.toString().substring(0, maxLength);
-                logger && logger.throwInternal(2 , _InternalMessageId.StringValueTooLong, "string value is too long. It has been truncated to " + maxLength + " characters.", { value: value }, true);
+                _throwInternal(logger, 2 , _InternalMessageId.StringValueTooLong, "string value is too long. It has been truncated to " + maxLength + " characters.", { value: value }, true);
             }
         }
         return valueTrunc || value;
@@ -1309,7 +1726,7 @@
         if (message) {
             if (message.length > 32768 ) {
                 messageTrunc = message.substring(0, 32768 );
-                logger && logger.throwInternal(2 , _InternalMessageId.MessageTruncated, "message is too long, it has been truncated to " + 32768  + " characters.", { message: message }, true);
+                _throwInternal(logger, 2 , _InternalMessageId.MessageTruncated, "message is too long, it has been truncated to " + 32768  + " characters.", { message: message }, true);
             }
         }
         return messageTrunc || message;
@@ -1320,7 +1737,7 @@
             var value = "" + exception;
             if (value.length > 32768 ) {
                 exceptionTrunc = value.substring(0, 32768 );
-                logger && logger.throwInternal(2 , _InternalMessageId.ExceptionTruncated, "exception is too long, it has been truncated to " + 32768  + " characters.", { exception: exception }, true);
+                _throwInternal(logger, 2 , _InternalMessageId.ExceptionTruncated, "exception is too long, it has been truncated to " + 32768  + " characters.", { exception: exception }, true);
             }
         }
         return exceptionTrunc || exception;
@@ -1334,7 +1751,7 @@
                         value = getJSON().stringify(value);
                     }
                     catch (e) {
-                        logger && logger.throwInternal(2 , _InternalMessageId.CannotSerializeObjectNonSerializable, "custom property is not valid", { exception: e }, true);
+                        _throwInternal(logger, 2 , _InternalMessageId.CannotSerializeObjectNonSerializable, "custom property is not valid", { exception: e }, true);
                     }
                 }
                 value = dataSanitizeString(logger, value, 8192 );
@@ -1365,7 +1782,7 @@
             input = strTrim(input);
             if (input.length > maxLength) {
                 inputTrunc = input.substring(0, maxLength);
-                logger && logger.throwInternal(2 , _msgId, "input is too long, it has been truncated to " + maxLength + " characters.", { data: input }, true);
+                _throwInternal(logger, 2 , _msgId, "input is too long, it has been truncated to " + maxLength + " characters.", { data: input }, true);
             }
         }
         return inputTrunc || input;
@@ -1503,8 +1920,12 @@
         _canUseLocalStorage = false;
         _canUseSessionStorage = false;
     }
-    function utlCanUseLocalStorage() {
-        if (_canUseLocalStorage === undefined) {
+    function utlEnableStorage() {
+        _canUseLocalStorage = utlCanUseLocalStorage(true);
+        _canUseSessionStorage = utlCanUseSessionStorage(true);
+    }
+    function utlCanUseLocalStorage(reset) {
+        if (reset || _canUseLocalStorage === undefined) {
             _canUseLocalStorage = !!_getVerifiedStorageObject(StorageType.LocalStorage);
         }
         return _canUseLocalStorage;
@@ -1517,7 +1938,7 @@
             }
             catch (e) {
                 _canUseLocalStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserCannotReadLocalStorage, "Browser failed read of local storage. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserCannotReadLocalStorage, "Browser failed read of local storage. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return null;
@@ -1531,7 +1952,7 @@
             }
             catch (e) {
                 _canUseLocalStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserCannotWriteLocalStorage, "Browser failed write to local storage. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserCannotWriteLocalStorage, "Browser failed write to local storage. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return false;
@@ -1545,13 +1966,13 @@
             }
             catch (e) {
                 _canUseLocalStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserFailedRemovalFromLocalStorage, "Browser failed removal of local storage item. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserFailedRemovalFromLocalStorage, "Browser failed removal of local storage item. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return false;
     }
-    function utlCanUseSessionStorage() {
-        if (_canUseSessionStorage === undefined) {
+    function utlCanUseSessionStorage(reset) {
+        if (reset || _canUseSessionStorage === undefined) {
             _canUseSessionStorage = !!_getVerifiedStorageObject(StorageType.SessionStorage);
         }
         return _canUseSessionStorage;
@@ -1573,7 +1994,7 @@
             }
             catch (e) {
                 _canUseSessionStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserCannotReadSessionStorage, "Browser failed read of session storage. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserCannotReadSessionStorage, "Browser failed read of session storage. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return null;
@@ -1587,7 +2008,7 @@
             }
             catch (e) {
                 _canUseSessionStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserCannotWriteSessionStorage, "Browser failed write to session storage. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserCannotWriteSessionStorage, "Browser failed write to session storage. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return false;
@@ -1601,7 +2022,7 @@
             }
             catch (e) {
                 _canUseSessionStorage = false;
-                logger.throwInternal(2 , _InternalMessageId.BrowserFailedRemovalFromSessionStorage, "Browser failed removal of session storage item. " + getExceptionName(e), { exception: dumpObj(e) });
+                _throwInternal(logger, 2 , _InternalMessageId.BrowserFailedRemovalFromSessionStorage, "Browser failed removal of session storage item. " + getExceptionName(e), { exception: dumpObj(e) });
             }
         }
         return false;
@@ -2921,6 +3342,7 @@
     exports.utlCanUseLocalStorage = utlCanUseLocalStorage;
     exports.utlCanUseSessionStorage = utlCanUseSessionStorage;
     exports.utlDisableStorage = utlDisableStorage;
+    exports.utlEnableStorage = utlEnableStorage;
     exports.utlGetLocalStorage = utlGetLocalStorage;
     exports.utlGetSessionStorage = utlGetSessionStorage;
     exports.utlGetSessionStorageKeys = utlGetSessionStorageKeys;