@qooxdoo/framework 7.0.0-beta.6 → 7.0.0

package/source/class/qx/log/Logger.js

@@ -57,64 +57,54 @@
  *
  * @require(qx.dev.StackTrace)
  */
-qx.Bootstrap.define("qx.log.Logger",
-{
-  statics :
-  {
+qx.Bootstrap.define("qx.log.Logger", {
+  statics: {
     /*
     ---------------------------------------------------------------------------
       CONFIGURATION
     ---------------------------------------------------------------------------
     */
 
-    __level : "debug",
-
+    __level: "debug",
 
     /**
      * Configures the minimum log level required for new messages.
      *
      * @param value {String} One of "debug", "info", "warn" or "error".
      */
-    setLevel : function(value) {
+    setLevel(value) {
       this.__level = value;
     },
 
-
     /**
      * Returns the currently configured minimum log level required for new
      * messages.
      *
      * @return {Integer} Debug level
      */
-    getLevel : function() {
+    getLevel() {
       return this.__level;
     },
 
-
     /**
      * Configures the number of messages to be kept in the buffer.
      *
      * @param value {Integer} Any positive integer
      */
-    setTreshold : function(value) {
+    setTreshold(value) {
       this.__buffer.setMaxMessages(value);
     },
 
-
     /**
      * Returns the currently configured number of messages to be kept in the
      * buffer.
      *
      * @return {Integer} Treshold value
      */
-    getTreshold : function() {
+    getTreshold() {
       return this.__buffer.getMaxMessages();
     },
 
-
-
-
-
     /*
     ---------------------------------------------------------------------------
       APPENDER MANAGEMENT
@@ -122,20 +112,16 @@ qx.Bootstrap.define("qx.log.Logger",
     */
 
     /** @type {Map} Map of all known appenders by ID */
-    __appenders : [],
-
+    __appenders: [],
 
     /** @type {Map} Map of all known appenders by name */
     __appendersByName: {},
 
-
     /** @type {Array} Array of filters to apply when selecting appenders to append to */
     __filters: [],
 
-
     /** @type {Integer} Last free appender ID */
-    __id : 0,
-
+    __id: 0,
 
     /**
      * Registers the given appender and inserts the last cached messages.
@@ -146,8 +132,7 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param appender {Class} A static appender class supporting at
      *   least a <code>process()</code> method to handle incoming messages.
      */
-    register : function(appender)
-    {
+    register(appender) {
       if (appender.$$id) {
         return;
       }
@@ -161,7 +146,7 @@ qx.Bootstrap.define("qx.log.Logger",
 
       // Insert previous messages
       var entries = this.__buffer.getAllLogEvents();
-      for (var i=0, l=entries.length; i<l; i++) {
+      for (var i = 0, l = entries.length; i < l; i++) {
         var entry = entries[i];
 
         var appenders = this.__getAppenders(entry.loggerName, entry.level);
@@ -171,14 +156,12 @@ qx.Bootstrap.define("qx.log.Logger",
       }
     },
 
-
     /**
      * Unregisters the given appender
      *
      * @param appender {Class} A static appender class
      */
-    unregister : function(appender)
-    {
+    unregister(appender) {
       var id = appender.$$id;
       if (id == null) {
         return;
@@ -190,7 +173,6 @@ qx.Bootstrap.define("qx.log.Logger",
       delete appender.$$id;
     },
 
-
     /**
      * Adds a filter that specifies the appenders to use for a given logger name (classname).
      *
@@ -234,22 +216,24 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param appenderName {String?} the name of the appender class, if undefined then all appenders
      * @param level {String?} the minimum logging level to use the appender, if undefined the default level is used
      */
-    addFilter: function(logger, appenderName, level) {
+    addFilter(logger, appenderName, level) {
       if (typeof logger == "string") {
         logger = new RegExp(logger);
       }
-      this.__filters.push({ loggerMatch: logger, level: level||this.__level, appenderName: appenderName });
+      this.__filters.push({
+        loggerMatch: logger,
+        level: level || this.__level,
+        appenderName: appenderName
+      });
     },
 
     /**
      * Reset all filters
      */
-    resetFilters: function() {
+    resetFilters() {
       this.__filters = [];
     },
 
-
-
     /*
     ---------------------------------------------------------------------------
       USER METHODS
@@ -264,11 +248,10 @@ qx.Bootstrap.define("qx.log.Logger",
      *   have any JavaScript data type. All data is serialized immediately and
      *   does not keep references to other objects.
      */
-    debug : function(object, message) {
+    debug(object, message) {
       qx.log.Logger.__log("debug", arguments);
     },
 
-
     /**
      * Sending a message at level "info" to the logger.
      *
@@ -277,11 +260,10 @@ qx.Bootstrap.define("qx.log.Logger",
      *   have any JavaScript data type. All data is serialized immediately and
      *   does not keep references to other objects.
      */
-    info : function(object, message) {
+    info(object, message) {
       qx.log.Logger.__log("info", arguments);
     },
 
-
     /**
      * Sending a message at level "warn" to the logger.
      *
@@ -290,11 +272,10 @@ qx.Bootstrap.define("qx.log.Logger",
      *   have any JavaScript data type. All data is serialized immediately and
      *   does not keep references to other objects.
      */
-    warn : function(object, message) {
+    warn(object, message) {
       qx.log.Logger.__log("warn", arguments);
     },
 
-
     /**
      * Sending a message at level "error" to the logger.
      *
@@ -303,11 +284,10 @@ qx.Bootstrap.define("qx.log.Logger",
      *   have any JavaScript data type. All data is serialized immediately and
      *   does not keep references to other objects.
      */
-    error : function(object, message) {
+    error(object, message) {
       qx.log.Logger.__log("error", arguments);
     },
 
-
     /**
      * Prints the current stack trace at level "info"
      *
@@ -316,7 +296,7 @@ qx.Bootstrap.define("qx.log.Logger",
      *   have any JavaScript data type. All data is serialized immediately and
      *   does not keep references to other objects.
      */
-    trace : function(object, message) {
+    trace(object, message) {
       if (qx.log.Logger.isLoggerEnabled("trace", object)) {
         var trace = qx.dev.StackTrace.getStackTrace();
         var args = qx.lang.Array.fromArguments(arguments);
@@ -325,7 +305,6 @@ qx.Bootstrap.define("qx.log.Logger",
       }
     },
 
-
     /**
      * Prints a method deprecation warning and a stack trace if the setting
      * <code>qx.debug</code> is set to <code>true</code>.
@@ -334,20 +313,21 @@ qx.Bootstrap.define("qx.log.Logger",
      *     arguments.callee if the calling method is to be deprecated.
      * @param msg {String?} Optional message to be printed.
      */
-    deprecatedMethodWarning : function(fcn, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecatedMethodWarning(fcn, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         var functionName = qx.lang.Function.getName(fcn);
         this.warn(
-          "The method '"+ functionName + "' is deprecated: " +
-          (msg || "Please consult the API documentation of this method for alternatives.")
+          "The method '" +
+            functionName +
+            "' is deprecated: " +
+            (msg ||
+              "Please consult the API documentation of this method for alternatives.")
         );
+
         this.trace();
       }
     },
 
-
     /**
      * Prints a class deprecation warning and a stack trace if the setting
      * <code>qx.debug</code> is set to <code>true</code>.
@@ -355,20 +335,21 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param clazz {Class} reference to the deprecated class.
      * @param msg {String?} Optional message to be printed.
      */
-    deprecatedClassWarning : function(clazz, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecatedClassWarning(clazz, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         var className = clazz.classname || "unknown";
         this.warn(
-          "The class '"+className+"' is deprecated: " +
-          (msg || "Please consult the API documentation of this class for alternatives.")
+          "The class '" +
+            className +
+            "' is deprecated: " +
+            (msg ||
+              "Please consult the API documentation of this class for alternatives.")
         );
+
         this.trace();
       }
     },
 
-
     /**
      * Prints an event deprecation warning and a stack trace if the setting
      * <code>qx.debug</code> is set to <code>true</code>.
@@ -377,20 +358,23 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param event {String} deprecated event name.
      * @param msg {String?} Optional message to be printed.
      */
-    deprecatedEventWarning : function(clazz, event, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecatedEventWarning(clazz, event, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         var className = clazz.self ? clazz.self.classname : "unknown";
         this.warn(
-          "The event '"+(event || "unknown")+"' from class '"+className+"' is deprecated: " +
-          (msg || "Please consult the API documentation of this class for alternatives.")
+          "The event '" +
+            (event || "unknown") +
+            "' from class '" +
+            className +
+            "' is deprecated: " +
+            (msg ||
+              "Please consult the API documentation of this class for alternatives.")
         );
+
         this.trace();
       }
     },
 
-
     /**
      * Prints a mixin deprecation warning and a stack trace if the setting
      * <code>qx.debug</code> is set to <code>true</code>.
@@ -398,20 +382,21 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param clazz {Class} reference to the deprecated mixin.
      * @param msg {String?} Optional message to be printed.
      */
-    deprecatedMixinWarning : function(clazz, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecatedMixinWarning(clazz, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         var mixinName = clazz ? clazz.name : "unknown";
         this.warn(
-          "The mixin '"+mixinName+"' is deprecated: " +
-          (msg || "Please consult the API documentation of this class for alternatives.")
+          "The mixin '" +
+            mixinName +
+            "' is deprecated: " +
+            (msg ||
+              "Please consult the API documentation of this class for alternatives.")
         );
+
         this.trace();
       }
     },
 
-
     /**
      * Prints a constant deprecation warning and a stacktrace if the setting
      * <code>qx.debug</code> is set to <code>true</code> AND the browser supports
@@ -421,19 +406,21 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param constant {String} The name of the constant as string.
      * @param msg {String} Optional message to be printed.
      */
-    deprecatedConstantWarning : function(clazz, constant, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecatedConstantWarning(clazz, constant, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         // check if __defineGetter__ is available
         if (clazz.__defineGetter__) {
           var self = this;
           var constantValue = clazz[constant];
-          clazz.__defineGetter__(constant, function() {
+          clazz.__defineGetter__(constant, function () {
             self.warn(
-              "The constant '"+ constant + "' is deprecated: " +
-              (msg || "Please consult the API documentation for alternatives.")
+              "The constant '" +
+                constant +
+                "' is deprecated: " +
+                (msg ||
+                  "Please consult the API documentation for alternatives.")
             );
+
             self.trace();
             return constantValue;
           });
@@ -441,7 +428,6 @@ qx.Bootstrap.define("qx.log.Logger",
       }
     },
 
-
     /**
      * Prints a deprecation warning and a stacktrace when a subclass overrides
      * the passed method name. The deprecation is only printed if the setting
@@ -453,20 +439,18 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param methodName {String} The method name which is deprecated for overriding.
      * @param msg {String?} Optional message to be printed.
      */
-    deprecateMethodOverriding : function(object, baseclass, methodName, msg)
-    {
-      if (qx.core.Environment.get("qx.debug"))
-      {
+    deprecateMethodOverriding(object, baseclass, methodName, msg) {
+      if (qx.core.Environment.get("qx.debug")) {
         var clazz = object.constructor;
 
-        while(clazz.classname !== baseclass.classname)
-        {
-          if (clazz.prototype.hasOwnProperty(methodName))
-          {
+        while (clazz.classname !== baseclass.classname) {
+          if (clazz.prototype.hasOwnProperty(methodName)) {
             this.warn(
               `The method ' ${clazz.classname}.${methodName}' overrides a deprecated method:
               (msg || "Please consult the API documentation for alternatives.")
-              `);
+              `
+            );
+
             this.trace();
             break;
           }
@@ -475,19 +459,15 @@ qx.Bootstrap.define("qx.log.Logger",
       }
     },
 
-
     /**
      * Deletes the current buffer. Does not influence message handling of the
      * connected appenders.
      *
      */
-    clear : function() {
+    clear() {
       this.__buffer.clearHistory();
     },
 
-
-
-
     /*
     ---------------------------------------------------------------------------
       INTERNAL LOGGING IMPLEMENTATION
@@ -495,30 +475,27 @@ qx.Bootstrap.define("qx.log.Logger",
     */
 
     /** @type {qx.log.appender.RingBuffer} Message buffer of previously fired messages. */
-    __buffer : new qx.log.appender.RingBuffer(50),
-
+    __buffer: new qx.log.appender.RingBuffer(50),
 
     /** @type {Map} Numeric translation of log levels */
-    __levels :
-    {
+    __levels: {
       trace: 0,
-      debug : 1,
-      info : 2,
-      warn : 3,
-      error : 4
+      debug: 1,
+      info: 2,
+      warn: 3,
+      error: 4
     },
 
     /** @type {Map} cache of appenders for a given logger and level */
     __appendersCache: {},
 
-
     /**
      * Detects the name of the logger to use for an object
      *
      * @param object {Object} Contextual object (either instance or static class)
      * @return {String} Logger name
      */
-    __getLoggerName: function(object) {
+    __getLoggerName(object) {
       if (object) {
         if (object.classname) {
           return object.classname;
@@ -530,7 +507,6 @@ qx.Bootstrap.define("qx.log.Logger",
       return "[default]";
     },
 
-
     /**
      * Detects whether a logger level is enabled for an object
      *
@@ -538,13 +514,12 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param object {Object} Contextual object (either instance or static class)
      * @return {Boolean} True if the logger is enabled
      */
-    isLoggerEnabled: function(level, object) {
+    isLoggerEnabled(level, object) {
       var loggerName = this.__getLoggerName(object);
       var appenders = this.__getAppenders(loggerName, level);
       return !!Object.keys(appenders).length;
     },
 
-
     /**
      * Internal logging main routine.
      *
@@ -552,8 +527,7 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param args {Array} List of other arguments, where the first is
      *   taken as the context object.
      */
-    __log : function(level, args)
-    {
+    __log(level, args) {
       // Get object and determine appenders
       var object = args.length < 2 ? null : args[0];
       var loggerName = this.__getLoggerName(object);
@@ -565,16 +539,15 @@ qx.Bootstrap.define("qx.log.Logger",
       // Serialize and cache
       var start = object ? 1 : 0;
       var items = [];
-      for (var i=start, l=args.length; i<l; i++) {
+      for (var i = start, l = args.length; i < l; i++) {
         items.push(this.__serialize(args[i], true));
       }
 
       // Build entry
-      var time = new Date;
-      var entry =
-      {
-        time : time,
-        offset : time-qx.Bootstrap.LOADSTART,
+      var time = new Date();
+      var entry = {
+        time: time,
+        offset: time - qx.Bootstrap.LOADSTART,
         level: level,
         loggerName: loggerName,
         items: items,
@@ -583,8 +556,7 @@ qx.Bootstrap.define("qx.log.Logger",
       };
 
       // Add relation fields
-      if (object)
-      {
+      if (object) {
         if (qx.Bootstrap.isQxCoreObject(object)) {
           entry.object = object.toHashCode();
         }
@@ -603,7 +575,6 @@ qx.Bootstrap.define("qx.log.Logger",
       }
     },
 
-
     /**
      * Finds the appenders for a given classname
      *
@@ -611,7 +582,7 @@ qx.Bootstrap.define("qx.log.Logger",
      * @param level {String} the minimum logging level to use the appender
      * @return {Array} list of appenders
      */
-    __getAppenders: function(className, level) {
+    __getAppenders(className, level) {
       var levels = this.__levels;
 
       // If no filters, then all appenders apply
@@ -647,19 +618,17 @@ qx.Bootstrap.define("qx.log.Logger",
         // Test
         if (!filter.loggerMatch || filter.loggerMatch.test(className)) {
           if (filter.appenderName) {
-            appenders[filter.appenderName] = this.__appendersByName[filter.appenderName];
-          }
-          else {
-            return this.__appendersCache[cacheId] = this.__appendersByName;
+            appenders[filter.appenderName] =
+              this.__appendersByName[filter.appenderName];
+          } else {
+            return (this.__appendersCache[cacheId] = this.__appendersByName);
           }
         }
       }
 
-      return this.__appendersCache[cacheId] = appenders;
+      return (this.__appendersCache[cacheId] = appenders);
     },
 
-
-
     /**
      * Detects the type of the variable given.
      *
@@ -669,8 +638,7 @@ qx.Bootstrap.define("qx.log.Logger",
      *   "function", "array", "error", "map",
      *   "class", "instance", "node", "stringify", "unknown"
      */
-    __detect : function(value)
-    {
+    __detect(value) {
       if (value === undefined) {
         return "undefined";
       } else if (value === null) {
@@ -683,12 +651,14 @@ qx.Bootstrap.define("qx.log.Logger",
 
       var type = typeof value;
 
-      if (type === "function" || type == "string" || type === "number" || type === "boolean") {
+      if (
+        type === "function" ||
+        type == "string" ||
+        type === "number" ||
+        type === "boolean"
+      ) {
         return type;
-      }
-
-      else if (type === "object")
-      {
+      } else if (type === "object") {
         if (value.nodeType) {
           return "node";
           // In Gecko, DOMException doesn't inherit from Error
@@ -712,7 +682,6 @@ qx.Bootstrap.define("qx.log.Logger",
       return "unknown";
     },
 
-
     /**
      * Serializes the incoming value. If it is a singular value, the result is
      * a simple string. For an array or a map the result can also be a
@@ -724,14 +693,12 @@ qx.Bootstrap.define("qx.log.Logger",
      * @return {Map} Contains the keys <code>type</code>, <code>text</code> and
      * <code>trace</code>.
      */
-    __serialize : function(value, deep)
-    {
+    __serialize(value, deep) {
       var type = this.__detect(value);
       var text = "unknown";
       var trace = [];
 
-      switch(type)
-      {
+      switch (type) {
         case "null":
         case "undefined":
           text = type;
@@ -745,23 +712,16 @@ qx.Bootstrap.define("qx.log.Logger",
           break;
 
         case "node":
-          if (value.nodeType === 9)
-          {
+          if (value.nodeType === 9) {
             text = "document";
-          }
-          else if (value.nodeType === 3)
-          {
+          } else if (value.nodeType === 3) {
             text = "text[" + value.nodeValue + "]";
-          }
-          else if (value.nodeType === 1)
-          {
+          } else if (value.nodeType === 1) {
             text = value.nodeName.toLowerCase();
             if (value.id) {
               text += "#" + value.id;
             }
-          }
-          else
-          {
+          } else {
             text = "node";
           }
           break;
@@ -778,34 +738,28 @@ qx.Bootstrap.define("qx.log.Logger",
 
         case "error":
           trace = qx.dev.StackTrace.getStackTraceFromError(value);
-          text = (value.basename ? value.basename + ": " : "") +
-                 value.toString();
+          text =
+            (value.basename ? value.basename + ": " : "") + value.toString();
           break;
 
         case "array":
-          if (deep)
-          {
+          if (deep) {
             text = [];
-            for (var i=0, l=value.length; i<l; i++)
-            {
-              if (text.length > 20)
-              {
-                text.push("...(+" + (l-i) + ")");
+            for (var i = 0, l = value.length; i < l; i++) {
+              if (text.length > 20) {
+                text.push("...(+" + (l - i) + ")");
                 break;
               }
 
               text.push(this.__serialize(value[i], false));
             }
-          }
-          else
-          {
+          } else {
             text = "[...(" + value.length + ")]";
           }
           break;
 
         case "map":
-          if (deep)
-          {
+          if (deep) {
             var temp;
 
             // Produce sorted key list
@@ -817,11 +771,9 @@ qx.Bootstrap.define("qx.log.Logger",
 
             // Temporary text list
             text = [];
-            for (var i=0, l=sorted.length; i<l; i++)
-            {
-              if (text.length > 20)
-              {
-                text.push("...(+" + (l-i) + ")");
+            for (var i = 0, l = sorted.length; i < l; i++) {
+              if (text.length > 20) {
+                text.push("...(+" + (l - i) + ")");
                 break;
               }
 
@@ -831,10 +783,8 @@ qx.Bootstrap.define("qx.log.Logger",
               temp.key = key;
               text.push(temp);
             }
-          }
-          else
-          {
-            var number=0;
+          } else {
+            var number = 0;
             for (var key in value) {
               number++;
             }
@@ -844,18 +794,16 @@ qx.Bootstrap.define("qx.log.Logger",
       }
 
       return {
-        type : type,
-        text : text,
-        trace : trace
+        type: type,
+        text: text,
+        trace: trace
       };
     }
   },
 
-
-  defer : function(statics)
-  {
+  defer(statics) {
     var logs = qx.Bootstrap.$$logs;
-    for (var i=0; i<logs.length; i++) {
+    for (var i = 0; i < logs.length; i++) {
       statics.__log(logs[i][0], logs[i][1]);
     }