[6a3a178] | 1 |
|
---|
| 2 | /**
|
---|
| 3 | * This is the common logic for both the Node.js and web browser
|
---|
| 4 | * implementations of `debug()`.
|
---|
| 5 | *
|
---|
| 6 | * Expose `debug()` as the module.
|
---|
| 7 | */
|
---|
| 8 |
|
---|
| 9 | exports = module.exports = createDebug.debug = createDebug['default'] = createDebug;
|
---|
| 10 | exports.coerce = coerce;
|
---|
| 11 | exports.disable = disable;
|
---|
| 12 | exports.enable = enable;
|
---|
| 13 | exports.enabled = enabled;
|
---|
| 14 | exports.humanize = require('ms');
|
---|
| 15 |
|
---|
| 16 | /**
|
---|
| 17 | * The currently active debug mode names, and names to skip.
|
---|
| 18 | */
|
---|
| 19 |
|
---|
| 20 | exports.names = [];
|
---|
| 21 | exports.skips = [];
|
---|
| 22 |
|
---|
| 23 | /**
|
---|
| 24 | * Map of special "%n" handling functions, for the debug "format" argument.
|
---|
| 25 | *
|
---|
| 26 | * Valid key names are a single, lower or upper-case letter, i.e. "n" and "N".
|
---|
| 27 | */
|
---|
| 28 |
|
---|
| 29 | exports.formatters = {};
|
---|
| 30 |
|
---|
| 31 | /**
|
---|
| 32 | * Previous log timestamp.
|
---|
| 33 | */
|
---|
| 34 |
|
---|
| 35 | var prevTime;
|
---|
| 36 |
|
---|
| 37 | /**
|
---|
| 38 | * Select a color.
|
---|
| 39 | * @param {String} namespace
|
---|
| 40 | * @return {Number}
|
---|
| 41 | * @api private
|
---|
| 42 | */
|
---|
| 43 |
|
---|
| 44 | function selectColor(namespace) {
|
---|
| 45 | var hash = 0, i;
|
---|
| 46 |
|
---|
| 47 | for (i in namespace) {
|
---|
| 48 | hash = ((hash << 5) - hash) + namespace.charCodeAt(i);
|
---|
| 49 | hash |= 0; // Convert to 32bit integer
|
---|
| 50 | }
|
---|
| 51 |
|
---|
| 52 | return exports.colors[Math.abs(hash) % exports.colors.length];
|
---|
| 53 | }
|
---|
| 54 |
|
---|
| 55 | /**
|
---|
| 56 | * Create a debugger with the given `namespace`.
|
---|
| 57 | *
|
---|
| 58 | * @param {String} namespace
|
---|
| 59 | * @return {Function}
|
---|
| 60 | * @api public
|
---|
| 61 | */
|
---|
| 62 |
|
---|
| 63 | function createDebug(namespace) {
|
---|
| 64 |
|
---|
| 65 | function debug() {
|
---|
| 66 | // disabled?
|
---|
| 67 | if (!debug.enabled) return;
|
---|
| 68 |
|
---|
| 69 | var self = debug;
|
---|
| 70 |
|
---|
| 71 | // set `diff` timestamp
|
---|
| 72 | var curr = +new Date();
|
---|
| 73 | var ms = curr - (prevTime || curr);
|
---|
| 74 | self.diff = ms;
|
---|
| 75 | self.prev = prevTime;
|
---|
| 76 | self.curr = curr;
|
---|
| 77 | prevTime = curr;
|
---|
| 78 |
|
---|
| 79 | // turn the `arguments` into a proper Array
|
---|
| 80 | var args = new Array(arguments.length);
|
---|
| 81 | for (var i = 0; i < args.length; i++) {
|
---|
| 82 | args[i] = arguments[i];
|
---|
| 83 | }
|
---|
| 84 |
|
---|
| 85 | args[0] = exports.coerce(args[0]);
|
---|
| 86 |
|
---|
| 87 | if ('string' !== typeof args[0]) {
|
---|
| 88 | // anything else let's inspect with %O
|
---|
| 89 | args.unshift('%O');
|
---|
| 90 | }
|
---|
| 91 |
|
---|
| 92 | // apply any `formatters` transformations
|
---|
| 93 | var index = 0;
|
---|
| 94 | args[0] = args[0].replace(/%([a-zA-Z%])/g, function(match, format) {
|
---|
| 95 | // if we encounter an escaped % then don't increase the array index
|
---|
| 96 | if (match === '%%') return match;
|
---|
| 97 | index++;
|
---|
| 98 | var formatter = exports.formatters[format];
|
---|
| 99 | if ('function' === typeof formatter) {
|
---|
| 100 | var val = args[index];
|
---|
| 101 | match = formatter.call(self, val);
|
---|
| 102 |
|
---|
| 103 | // now we need to remove `args[index]` since it's inlined in the `format`
|
---|
| 104 | args.splice(index, 1);
|
---|
| 105 | index--;
|
---|
| 106 | }
|
---|
| 107 | return match;
|
---|
| 108 | });
|
---|
| 109 |
|
---|
| 110 | // apply env-specific formatting (colors, etc.)
|
---|
| 111 | exports.formatArgs.call(self, args);
|
---|
| 112 |
|
---|
| 113 | var logFn = debug.log || exports.log || console.log.bind(console);
|
---|
| 114 | logFn.apply(self, args);
|
---|
| 115 | }
|
---|
| 116 |
|
---|
| 117 | debug.namespace = namespace;
|
---|
| 118 | debug.enabled = exports.enabled(namespace);
|
---|
| 119 | debug.useColors = exports.useColors();
|
---|
| 120 | debug.color = selectColor(namespace);
|
---|
| 121 |
|
---|
| 122 | // env-specific initialization logic for debug instances
|
---|
| 123 | if ('function' === typeof exports.init) {
|
---|
| 124 | exports.init(debug);
|
---|
| 125 | }
|
---|
| 126 |
|
---|
| 127 | return debug;
|
---|
| 128 | }
|
---|
| 129 |
|
---|
| 130 | /**
|
---|
| 131 | * Enables a debug mode by namespaces. This can include modes
|
---|
| 132 | * separated by a colon and wildcards.
|
---|
| 133 | *
|
---|
| 134 | * @param {String} namespaces
|
---|
| 135 | * @api public
|
---|
| 136 | */
|
---|
| 137 |
|
---|
| 138 | function enable(namespaces) {
|
---|
| 139 | exports.save(namespaces);
|
---|
| 140 |
|
---|
| 141 | exports.names = [];
|
---|
| 142 | exports.skips = [];
|
---|
| 143 |
|
---|
| 144 | var split = (typeof namespaces === 'string' ? namespaces : '').split(/[\s,]+/);
|
---|
| 145 | var len = split.length;
|
---|
| 146 |
|
---|
| 147 | for (var i = 0; i < len; i++) {
|
---|
| 148 | if (!split[i]) continue; // ignore empty strings
|
---|
| 149 | namespaces = split[i].replace(/\*/g, '.*?');
|
---|
| 150 | if (namespaces[0] === '-') {
|
---|
| 151 | exports.skips.push(new RegExp('^' + namespaces.substr(1) + '$'));
|
---|
| 152 | } else {
|
---|
| 153 | exports.names.push(new RegExp('^' + namespaces + '$'));
|
---|
| 154 | }
|
---|
| 155 | }
|
---|
| 156 | }
|
---|
| 157 |
|
---|
| 158 | /**
|
---|
| 159 | * Disable debug output.
|
---|
| 160 | *
|
---|
| 161 | * @api public
|
---|
| 162 | */
|
---|
| 163 |
|
---|
| 164 | function disable() {
|
---|
| 165 | exports.enable('');
|
---|
| 166 | }
|
---|
| 167 |
|
---|
| 168 | /**
|
---|
| 169 | * Returns true if the given mode name is enabled, false otherwise.
|
---|
| 170 | *
|
---|
| 171 | * @param {String} name
|
---|
| 172 | * @return {Boolean}
|
---|
| 173 | * @api public
|
---|
| 174 | */
|
---|
| 175 |
|
---|
| 176 | function enabled(name) {
|
---|
| 177 | var i, len;
|
---|
| 178 | for (i = 0, len = exports.skips.length; i < len; i++) {
|
---|
| 179 | if (exports.skips[i].test(name)) {
|
---|
| 180 | return false;
|
---|
| 181 | }
|
---|
| 182 | }
|
---|
| 183 | for (i = 0, len = exports.names.length; i < len; i++) {
|
---|
| 184 | if (exports.names[i].test(name)) {
|
---|
| 185 | return true;
|
---|
| 186 | }
|
---|
| 187 | }
|
---|
| 188 | return false;
|
---|
| 189 | }
|
---|
| 190 |
|
---|
| 191 | /**
|
---|
| 192 | * Coerce `val`.
|
---|
| 193 | *
|
---|
| 194 | * @param {Mixed} val
|
---|
| 195 | * @return {Mixed}
|
---|
| 196 | * @api private
|
---|
| 197 | */
|
---|
| 198 |
|
---|
| 199 | function coerce(val) {
|
---|
| 200 | if (val instanceof Error) return val.stack || val.message;
|
---|
| 201 | return val;
|
---|
| 202 | }
|
---|