You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

268 lines
8.4 KiB

5 years ago
  1. /*
  2. * loglevel - https://github.com/pimterry/loglevel
  3. *
  4. * Copyright (c) 2013 Tim Perry
  5. * Licensed under the MIT license.
  6. */
  7. (function (root, definition) {
  8. "use strict";
  9. if (typeof define === 'function' && define.amd) {
  10. define(definition);
  11. } else if (typeof module === 'object' && module.exports) {
  12. module.exports = definition();
  13. } else {
  14. root.log = definition();
  15. }
  16. }(this, function () {
  17. "use strict";
  18. // Slightly dubious tricks to cut down minimized file size
  19. var noop = function() {};
  20. var undefinedType = "undefined";
  21. var isIE = (typeof window !== undefinedType) && (
  22. /Trident\/|MSIE /.test(window.navigator.userAgent)
  23. );
  24. var logMethods = [
  25. "trace",
  26. "debug",
  27. "info",
  28. "warn",
  29. "error"
  30. ];
  31. // Cross-browser bind equivalent that works at least back to IE6
  32. function bindMethod(obj, methodName) {
  33. var method = obj[methodName];
  34. if (typeof method.bind === 'function') {
  35. return method.bind(obj);
  36. } else {
  37. try {
  38. return Function.prototype.bind.call(method, obj);
  39. } catch (e) {
  40. // Missing bind shim or IE8 + Modernizr, fallback to wrapping
  41. return function() {
  42. return Function.prototype.apply.apply(method, [obj, arguments]);
  43. };
  44. }
  45. }
  46. }
  47. // Trace() doesn't print the message in IE, so for that case we need to wrap it
  48. function traceForIE() {
  49. if (console.log) {
  50. if (console.log.apply) {
  51. console.log.apply(console, arguments);
  52. } else {
  53. // In old IE, native console methods themselves don't have apply().
  54. Function.prototype.apply.apply(console.log, [console, arguments]);
  55. }
  56. }
  57. if (console.trace) console.trace();
  58. }
  59. // Build the best logging method possible for this env
  60. // Wherever possible we want to bind, not wrap, to preserve stack traces
  61. function realMethod(methodName) {
  62. if (methodName === 'debug') {
  63. methodName = 'log';
  64. }
  65. if (typeof console === undefinedType) {
  66. return false; // No method possible, for now - fixed later by enableLoggingWhenConsoleArrives
  67. } else if (methodName === 'trace' && isIE) {
  68. return traceForIE;
  69. } else if (console[methodName] !== undefined) {
  70. return bindMethod(console, methodName);
  71. } else if (console.log !== undefined) {
  72. return bindMethod(console, 'log');
  73. } else {
  74. return noop;
  75. }
  76. }
  77. // These private functions always need `this` to be set properly
  78. function replaceLoggingMethods(level, loggerName) {
  79. /*jshint validthis:true */
  80. for (var i = 0; i < logMethods.length; i++) {
  81. var methodName = logMethods[i];
  82. this[methodName] = (i < level) ?
  83. noop :
  84. this.methodFactory(methodName, level, loggerName);
  85. }
  86. // Define log.log as an alias for log.debug
  87. this.log = this.debug;
  88. }
  89. // In old IE versions, the console isn't present until you first open it.
  90. // We build realMethod() replacements here that regenerate logging methods
  91. function enableLoggingWhenConsoleArrives(methodName, level, loggerName) {
  92. return function () {
  93. if (typeof console !== undefinedType) {
  94. replaceLoggingMethods.call(this, level, loggerName);
  95. this[methodName].apply(this, arguments);
  96. }
  97. };
  98. }
  99. // By default, we use closely bound real methods wherever possible, and
  100. // otherwise we wait for a console to appear, and then try again.
  101. function defaultMethodFactory(methodName, level, loggerName) {
  102. /*jshint validthis:true */
  103. return realMethod(methodName) ||
  104. enableLoggingWhenConsoleArrives.apply(this, arguments);
  105. }
  106. function Logger(name, defaultLevel, factory) {
  107. var self = this;
  108. var currentLevel;
  109. var storageKey = "loglevel";
  110. if (name) {
  111. storageKey += ":" + name;
  112. }
  113. function persistLevelIfPossible(levelNum) {
  114. var levelName = (logMethods[levelNum] || 'silent').toUpperCase();
  115. if (typeof window === undefinedType) return;
  116. // Use localStorage if available
  117. try {
  118. window.localStorage[storageKey] = levelName;
  119. return;
  120. } catch (ignore) {}
  121. // Use session cookie as fallback
  122. try {
  123. window.document.cookie =
  124. encodeURIComponent(storageKey) + "=" + levelName + ";";
  125. } catch (ignore) {}
  126. }
  127. function getPersistedLevel() {
  128. var storedLevel;
  129. if (typeof window === undefinedType) return;
  130. try {
  131. storedLevel = window.localStorage[storageKey];
  132. } catch (ignore) {}
  133. // Fallback to cookies if local storage gives us nothing
  134. if (typeof storedLevel === undefinedType) {
  135. try {
  136. var cookie = window.document.cookie;
  137. var location = cookie.indexOf(
  138. encodeURIComponent(storageKey) + "=");
  139. if (location !== -1) {
  140. storedLevel = /^([^;]+)/.exec(cookie.slice(location))[1];
  141. }
  142. } catch (ignore) {}
  143. }
  144. // If the stored level is not valid, treat it as if nothing was stored.
  145. if (self.levels[storedLevel] === undefined) {
  146. storedLevel = undefined;
  147. }
  148. return storedLevel;
  149. }
  150. /*
  151. *
  152. * Public logger API - see https://github.com/pimterry/loglevel for details
  153. *
  154. */
  155. self.name = name;
  156. self.levels = { "TRACE": 0, "DEBUG": 1, "INFO": 2, "WARN": 3,
  157. "ERROR": 4, "SILENT": 5};
  158. self.methodFactory = factory || defaultMethodFactory;
  159. self.getLevel = function () {
  160. return currentLevel;
  161. };
  162. self.setLevel = function (level, persist) {
  163. if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {
  164. level = self.levels[level.toUpperCase()];
  165. }
  166. if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {
  167. currentLevel = level;
  168. if (persist !== false) { // defaults to true
  169. persistLevelIfPossible(level);
  170. }
  171. replaceLoggingMethods.call(self, level, name);
  172. if (typeof console === undefinedType && level < self.levels.SILENT) {
  173. return "No console available for logging";
  174. }
  175. } else {
  176. throw "log.setLevel() called with invalid level: " + level;
  177. }
  178. };
  179. self.setDefaultLevel = function (level) {
  180. if (!getPersistedLevel()) {
  181. self.setLevel(level, false);
  182. }
  183. };
  184. self.enableAll = function(persist) {
  185. self.setLevel(self.levels.TRACE, persist);
  186. };
  187. self.disableAll = function(persist) {
  188. self.setLevel(self.levels.SILENT, persist);
  189. };
  190. // Initialize with the right level
  191. var initialLevel = getPersistedLevel();
  192. if (initialLevel == null) {
  193. initialLevel = defaultLevel == null ? "WARN" : defaultLevel;
  194. }
  195. self.setLevel(initialLevel, false);
  196. }
  197. /*
  198. *
  199. * Top-level API
  200. *
  201. */
  202. var defaultLogger = new Logger();
  203. var _loggersByName = {};
  204. defaultLogger.getLogger = function getLogger(name) {
  205. if (typeof name !== "string" || name === "") {
  206. throw new TypeError("You must supply a name when creating a logger.");
  207. }
  208. var logger = _loggersByName[name];
  209. if (!logger) {
  210. logger = _loggersByName[name] = new Logger(
  211. name, defaultLogger.getLevel(), defaultLogger.methodFactory);
  212. }
  213. return logger;
  214. };
  215. // Grab the current global log variable in case of overwrite
  216. var _log = (typeof window !== undefinedType) ? window.log : undefined;
  217. defaultLogger.noConflict = function() {
  218. if (typeof window !== undefinedType &&
  219. window.log === defaultLogger) {
  220. window.log = _log;
  221. }
  222. return defaultLogger;
  223. };
  224. defaultLogger.getLoggers = function getLoggers() {
  225. return _loggersByName;
  226. };
  227. return defaultLogger;
  228. }));