64

I would like to extend the 'console.log' function to add additional information to its output - but I dont want to affect the script name/line number information generated by the browser in the console window. See how if I create my own implementation, I get useless trace information, should I want to locate that region of code... (they all link to the log implementation, not the actual script that caused the log message)

enter image description here

Basically, my application is a very pluggable infrastructure, were any log output may occur within any number of frames. As such, I want every log message to include a special unique identifier at the beginning of the log message.

I have tried replacing the console.log method with my own, but chrome complains with Uncaught TypeError: Illegal invocation

this is how I override it

var orig = console.log;
console.log = function( message )
{
    orig( (window == top ? '[root]' : '[' + window.name + ']') + ': ' + message );
}

Any ideas?

[EDIT] Note: After fixing the 'illegal invocation' problem, it seems the filename/linenumber is still 'polluted' by the override...

[EDIT] It looks like the general answer is - NO - despite some confusing goose chases, the desired functionality is NOT achievable in the current versions of browsers.

Adam
  • 4,159
  • 4
  • 32
  • 53
  • As of today your last [EDIT] is finally not valid. See my answer http://stackoverflow.com/a/41328175/253098 – SystematicFrank Dec 26 '16 at 07:59
  • here's a great answer: http://stackoverflow.com/a/32928812/274502 – cregox Mar 06 '17 at 09:28
  • Almost duplicate of [javascript - A proper wrapper for console.log with correct line number? - Stack Overflow](https://stackoverflow.com/questions/13815640/a-proper-wrapper-for-console-log-with-correct-line-number/32928812#32928812) ; however that question is a special case that the `bind` solution works. – user202729 Feb 13 '21 at 10:00

16 Answers16

43

Yes, it is possible to add information without messing up the originating line numbers of the log invocation. Some of the other answers here came close, but the trick is to have your custom logging method return the modified logger. Below is a simple example that was only moderately tested that uses the context variant.

log = function() {
    var context = "My Descriptive Logger Prefix:";
    return Function.prototype.bind.call(console.log, console, context);
}();

This can be used with:

log("A log message..."); 

Here is a jsfiddle: http://jsfiddle.net/qprro98v/

One could get easily get creative and pass the context variable in, and remove the auto-executing parens from the function definition. i.e. log("DEBUG:")("A debug message"), log("INFO:")("Here is some info"), etc.

The only really import part about the function (in regards to line numbers) is that it returns the logger.

kylehuff
  • 5,177
  • 2
  • 34
  • 35
  • You can also add more than one parameter like `Function.prototype.bind.call(console.log, console, "%ccontext: ", "font-weight:bold;");` if i.e. you want output like: "**context:** log text" (at least in chrome and firefox) – Marco Sacchi Oct 04 '19 at 17:06
  • @MarcoSacchi How could I do if I want log all the message in green for exemple not only the prefix ? – LexaGC Mar 30 '20 at 18:46
13

If your use case can deal with a few restrictions, there is a way that this can be made to work. The restrictions are:

  • The extra log content has to be calculated at bind time; it cannot be time sensitive or depend on the incoming log message in any way.

  • The extra log content can only be place at the beginning of the log message.

With these restrictions, the following may work for you:

var context = "ALIASED LOG:"
var logalias;

if (console.log.bind === 'undefined') { // IE < 10
    logalias = Function.prototype.bind.call(console.log, console, context);
}
else {
    logalias = console.log.bind(console, context);
}

logalias('Hello, world!');

http://jsfiddle.net/Wk2mf/

Christopher Currie
  • 3,025
  • 1
  • 29
  • 40
10

An acceptable solution can be to make your own log-function that returns a console.log function bound with the log arguments.

log = function() {
    // Put your extension code here
    var args = Array.prototype.slice.call(arguments);  
    args.unshift(console);
    return Function.prototype.bind.apply(console.log, args);
}

// Note the extra () to call the original console.log
log("Foo", {bar: 1})();

This way the console.log call will be made from the correct line, and will be displayed nicely in the console, allowing you to click on it and everything.

ANisus
  • 74,460
  • 29
  • 162
  • 158
  • I think @kylehuff 's version is a bit better, but your version is very similar – Mephiztopheles Sep 02 '15 at 10:32
  • But what if i want conditional loggin? :D without setter i / function to call i dont have something in mind how to solve ( i solved with setter ) – Mephiztopheles Sep 02 '15 at 10:33
  • @Mephiztopheles Kylehuff's version differs in that it doesn't allow additional behaviour, such as logging to a file or sending the log to the server... or making condition checks. But if no additional behaviour is needed, I agree that Kylehuff's is better. – ANisus Jan 02 '16 at 14:38
8

It is actually possible in chrome at least. Here is the most relevant. This may vary depending on setup, and how i got the splits was to just log the whole stack, and find the information I needed.

        var stack = new Error().stack;
        var file = stack.split("\n")[2].split("/")[4].split("?")[0]
        var line = stack.split("\n")[2].split(":")[5];

Here is the whole thing, preserving the native object logging.

var orig = console.log
console.log = function(input) {
    var isChrome = navigator.userAgent.indexOf("Chrome") !== -1;
    if(isChrome){
        var stack = new Error().stack;
        var file = stack.split("\n")[2].split("/")[4].split("?")[0]
        var line = stack.split("\n")[2].split(":")[5];
        var append = file + ":" + line;
    }
    orig.apply(console, [input, append])
}
Bradley
  • 81
  • 1
  • 3
  • 2
    The concept behind this hack is definitely sound, but `stack.split("\n")[2].split(":")[5]`? What the heck do your errors look like? That 5th index is out of range for me; I'm struggling to guess at what's different in whatever browser you're using such that you have multiple extra colons on a line compared to what I see. – Mark Amery Apr 13 '13 at 17:24
  • I got that by just logging the whole thing and splitting it down till I got what I needed. I'm not sure why the differences exist. – Bradley May 02 '13 at 15:14
  • The differences are caused by the fact that the stack is different for codebase. You have a LINE1 which has a logging command and you want to get it's position. It matters how many function calls are from LINE1 to your new Error() call. The more calls there is, more deeper in the stack you have to go. – Capaj Jun 06 '14 at 16:05
3

You need to call the console.log with the correct context (console):

orig.call(console, message);

To complete your function allowing multiple arguments:

var orig = console.log;
console.log = function() {
    var msgs = [],
        prefix = (window== top ? '[root]' : '[' + window.name + ']');
    while(arguments.length) {
        msgs.push(prefix + ': ' + [].shift.call(arguments));
    }
    orig.apply(console, msgs);
};

Demo: http://jsfiddle.net/je2wR/

Remember that you loose the built-in object/array browser in the console when combining objects with strings using the + sign.

David Hellsing
  • 106,495
  • 44
  • 176
  • 212
  • 3
    Thanks David - unfortunatley, despite your well-written code, it seems that the original problem remains. In your jsfiddle, chrome reports that it is 'line 30' that generated the log output (`orig.apply(console, msgs);`), when I need it to actually say line 30 - as if console.log wasnt overridden... This is the crux of what Im getting at, overriding console.log seems to break the console stack trace. – Adam Mar 05 '12 at 01:06
  • OK i misunderstood, I looked at your code and assumed you had a coding problem with the custom log function. – David Hellsing Mar 05 '12 at 08:30
  • Yeah I probably was a little ambiguous, I think I had tunnel vision that the override was going to solve the problem. I had beaten my head against this one for a little while, and I figure there must be some 'magic API' that you call to pop a stack from the stack from before calling 'console.log' to ensure that the 'parent' file/line is used... cant find any documentation however. Perhaps its internal and not available to JS developers... *wishful thinking* Shout out to any Google Chrome devs who might be listening?? – Adam Mar 05 '12 at 20:48
  • Ha - just noticed I mentioned 'line 30' twice in my comment - I meant to write that Chrome reports 'line 27' as the source of the log event, but I need 'line 30' to be the source... otherwise EVERY log event ever generated will point to 'line 27' in the logging script. – Adam Sep 18 '12 at 02:02
2

I just answered this on a post that helped me answer the original 'alias' question:

(http://stackoverflow.com/a/12942764/401735)

my_log_alias = console.log.bind(console)

Apparently the capacity to do this has been designed in. Tested. Works.

thereafter my_log_alias is the same as console.log and can be called in the same way; Calling this from inside the function will report the line number for that function call, including the line inside of an alias or advice function where applicable.

Specifically, the line number Chrome provides will tell you the file the line is in, so what you are doing may be unneccesary; Consider reporting this as a bug/feature request in chrome that it provide this info in console.log.

Ben West
  • 660
  • 5
  • 17
  • Unfortunately, calling `my_log_alias('test')` still outputs the line number of the alias function, not the original caller as desired, rendering all line numbers useless. – Adam Dec 16 '12 at 20:36
  • 1
    Really? using the above method? Is it possible some other plugin has already advised the method and that you are calling the alias? does it report the line number you've implemented this on? and are you calling my_log_alias from inside YOUR alias, or are you calling it directly? – Ben West Dec 19 '12 at 18:49
  • I don't suppose you could create a fiddle showing this working? Just the snippet above alone isn't quite enough to be sure we are talking about the same scenario... – Adam Dec 19 '12 at 20:15
  • Truthfully, I think that the answer to your question is 'no, you can't append values to the console.log list without losing your line numbers.' perhaps you should just include a reference to the window when you add the log statement to your code, in-general. – Ben West Dec 19 '12 at 21:16
2

Christopher Currie provided an excellent solution. I've expanded it a bit for my needs. Here's the AMD module:

define([], function () {

    var enableDebug = true;
    var separator = ">";    

    function bind(f, thisArg, ctx) {
        if (f.bind !== 'undefined') { // IE < 10
            return Function.prototype.bind.call(f, thisArg, ctx);
        }
        else {
            return f.bind(thisArg, ctx);
        }
    }

    function newConsole(context, parentConsole) {
        var log;
        var debug;
        var warn;
        var error;

        if (!parentConsole) {
            parentConsole = console;
        }

        context = context + separator;


        if (enableDebug) {
            debug = bind(console.log, console, context + "DEBUG" + separator);
        } else {
            debug = function () {
                // suppress all debug messages
            };
        }

        log = bind(console.log, console, context);

        warn = bind(console.warn, console, context);

        error = bind(console.error, console, context);

        return {
            debug: debug,
            info: log,
            log: log,
            warn: warn,
            error: error,
            /* access console context information */
            context: context,
            /* create a new console with nested context */
            nest: function (subContext) {
                return newConsole(context + subContext, this);
            },
            parent: parentConsole
        };
    }

    return newConsole("");
});

By default this will output > {message}. You can also add nested context to you logging, e.g. console.nest("my").log("test") will output >my> test.

I've also added a debug function that will indent messages with >DEBUG>

Hope somebody will find it useful.

Muxa
  • 5,563
  • 6
  • 46
  • 56
2

Not long ago Chrome introduced a feature that can solve your problem without code hacks. It is called "blackbox" which basically allows you to mark files which should be ignored with their tools.

https://gist.github.com/paulirish/c307a5a585ddbcc17242

Yes, this solution is browser specific, but if you are using Chrome you do want this solution.

The solutions with a huge hack around throwing an Error for each log can show the right line, but it will not be a clickable link in your console.

The solutions based on binding/aliasing only enables you to modify the printed text. You will not be able to forward the arguments to a third function for further processing.

SystematicFrank
  • 16,555
  • 7
  • 56
  • 102
  • This answer is close to NAA[link-only], except that it does mention the name of the feature (blackbox). – user202729 Feb 13 '21 at 09:56
  • 1
    Chrome under the instruction of Edge decided to remove good uses of the word black... now it's been renamed to "Framework ignore list"... I use `/logger\..?(j|t)s$` – Ray Foss Apr 23 '21 at 18:19
1

I have looked into this several times and always found it was not possible.

My workaround if you are interested is to assign console to another variable and then wrap all my log messages in a function which lets me modify/style/whatever on the message.

It looks nice with CoffeeScript, not sure its practical with plain JS.

I just get into the habit of prefixing everything with x.

logger.debug x 'Foo'

log x 'Bar'

log x('FooBar %o'), obj
vaughan
  • 6,982
  • 6
  • 47
  • 63
1

Unfrotuantly it's currenlty not possible, In the future we might be able to do it with the Proxy object in ECMAScript 6.

My use case was to auto-prefix console messages with helpful information like the arguments passed and executing method. at the moment the closest I got is using Function.prototype.apply.

A simple approach is to just write your debug statements as such:

console.info('=== LazyLoad.css(', arguments, '): css files are skipped, gives us a clean slate to style within theme\'s CSS.');

A complicated approach is to use helper function as per below, I personally now prefer the simple approach.

Extending 'console.debug' function approach

/* Debug prefixing function
 * ===========================
 * 
 * A helper used to provide useful prefixing information 
 * when calling `console.log`, `console.debug`, `console.error`.
 * But the catch is that to utilize one must leverage the 
 * `.apply` function as shown in the below examples.
 *
 * ```
 * console.debug.apply(console, _fDebugPrefix(arguments)
 *    .concat('your message'));
 *
 * // or if you need to pass non strings
 * console.debug.apply(console, _fDebugPrefix(arguments)
 *    .concat('json response was:', oJson));
 *
 *
 * // if you need to use strict mode ("use strict") one can't
 * // extract the function name but following approach works very
 * // well; updating the name is just a matter of search and replace
 * var aDebugPrefix = ['fYourFunctionName('
 *                     ,Array.prototype.slice.call(arguments, 0), 
 *                     ,')'];
 * console.debug.apply(console, 
 *                     aDebugPrefix.concat(['json response was:', oJson]));
 * ```
 */
function _fDebugPrefix(oArguments) {
    try {
        return [oArguments.callee.name + '('
                ,Array.prototype.slice.call(oArguments, 0)
                , ')'];
    }
    catch(err) { // are we in "use strict" mode ?
        return ['<callee.name unsupported in "use strict">('
                ,Array.prototype.slice.call(oArguments, 0)
                , ')'];
    }
}
Daniel Sokolowski
  • 11,982
  • 4
  • 69
  • 55
1

Reusable class in TS/JS

// File: LogLevel.ts
enum LogLevel {
   error = 0,
   warn,
   info,
   debug,
   verbose,
 }

 export default LogLevel;
// File: Logger.js
import LogLevel from "./LogLevel";

export default class Logger {
  static id = "App";
  static level = LogLevel.info;

  constructor(id) {
    this.id = id;

    const commonPrefix = `[${Logger.id}/${this.id}]`;

    const verboseContext = `[V]${commonPrefix}`;
    if (console.log.bind === "undefined") {
      // IE < 10
      this.verbose = Function.prototype.bind.call(console.log, console, verboseContext);
    } else {
      this.verbose = console.log.bind(console, verboseContext);
    }
    if (LogLevel.verbose > Logger.level) {
      this.verbose = function() {
        return // Suppress
      };
    }

    const debugContext = `[D]${commonPrefix}`;
    if (console.debug.bind === "undefined") {
      // IE < 10
      this.debug = Function.prototype.bind.call(console.debug, console, debugContext);
    } else {
      this.debug = console.debug.bind(console, debugContext);
    }
    if (LogLevel.debug > Logger.level) {
      this.debug = function() {
        return // Suppress
      };
    }

    const infoContext = `[I]${commonPrefix}`;
    if (console.info.bind === "undefined") {
      // IE < 10
      this.info = Function.prototype.bind.call(console.info, console, infoContext);
    } else {
      this.info = console.info.bind(console, infoContext);
    }
    if (LogLevel.info > Logger.level) {
      this.info = function() {
        return // Suppress
      };
    }

    const warnContext = `[W]${commonPrefix}`;
    if (console.warn.bind === "undefined") {
      // IE < 10
      this.warn = Function.prototype.bind.call(console.warn, console, warnContext);
    } else {
      this.warn = console.warn.bind(console, warnContext);
    }
    if (LogLevel.warn > Logger.level) {
      this.warn = function() {
        return // Suppress
      };
    }

    const errorContext = `[E]${commonPrefix}`;
    if (console.error.bind === "undefined") {
      // IE < 10
      this.error = Function.prototype.bind.call(console.error, console, errorContext);
    } else {
      this.error = console.error.bind(console, errorContext);
    }
    if (LogLevel.error > Logger.level) {
      this.error = function() {
        return // Suppress
      };
    }
  }
}

Usage (React):

// File: src/index.tsx

// ...

Logger.id = "MCA"
const env = new Env()
if (env.env == Environment.dev) {
  Logger.level = LogLevel.verbose
  const log = new Logger("Main")
  log.info("Environment is 'Development'")
}

///...
// File: src/App/CookieConsent/index.tsx
import React, { useEffect } from "react";
import { useCookies } from "react-cookie";
import "./index.scss";

import Logger from "@lib/Logger" // @lib is just alias configured in webpack.

const cookieName = "mca-cookie-consent";

// const log = new Logger(CookieConsent.name) // IMPORTANT! Don't put log instance here. It is too early! Put inside function.

export default function CookieConsent(): JSX.Element {
  const log = new Logger(CookieConsent.name) // IMPORTANT! Have to be inside function, not in global scope (after imports)

  useEffect(() => {
    log.verbose(`Consent is accepted: ${isAccepted()}`);
  }, []);

  const [cookie, setCookie] = useCookies([cookieName]);

  function isAccepted(): boolean {
    return cookie[cookieName] != undefined;
  }

  function containerStyle(): React.CSSProperties {
    return isAccepted() ? { display: "none" } : {};
  }

  function handleClick() {
    const expires = new Date();
    expires.setFullYear(expires.getFullYear() + 1);
    log.verbose(`Accepted cookie consent. Expiration: ${expires}`)
    setCookie(cookieName, true, { path: "/", expires: expires, sameSite: "lax" });
  }

  return (
    <div className="cookieContainer" style={containerStyle()}>
      <div className="cookieContent">
        <div>
          <p className="cookieText">This website uses cookies to enhance the user experience.</p>
        </div>
        <div>
          <button onClick={handleClick} className="cookieButton">
            I understand
          </button>
        </div>
      </div>
    </div>
  );
}

Output in browser console:

20:47:48.190 [I][MCA/Main] Environment is 'Development' index.tsx:19
20:47:48.286 [V][MCA/CookieConsent] Consent is accepted: false index.tsx:13
20:47:52.250 [V][MCA/CookieConsent] Accepted cookie consent. Expiration: Sun Jan 30 2022 20:47:52 GMT+0100 (Central European Standard Time) index.tsx:29
Vlad
  • 6,402
  • 1
  • 60
  • 74
1

Hope this helps for some of your cases...

const log = console.log;
export default function middleWare(optionalStringExtension = '') {
    console.log = (...args) => {
        log(...args, optionalStringExtension);
    }
}

Either run as middleware, top of file, or first line of function.

Vontei
  • 1,727
  • 2
  • 14
  • 16
0

I ran into this issue as well about extending console.log() so that the application can extend, control and do fancy stuff with it in addition to logging stuff to the console. Losing the line number information was tantamount to failure, however. After wrestling with the issue, I came up with a long-winded workaround, but at least it's still a "1-liner" to use.

First, define a global class to use or add some methods to your main existing "app" class:

/**
 * Log message to our in-app and possibly on-screen console, return args.
 * @param {!string} aMsgLevel - one of "log", "debug", "info", "warn", or "error"
 * @param {any} aArgs - the arguments to log (not used directly, just documentation helper)
 * @returns args so it can be nested within a console.log.apply(console,app.log()) statement.
 */
MyGlobalClassWithLogMethods.prototype.debugLog = function(aMsgLevel, aArgs) {
    var s = '';
    var args = [];
    for (var i=1; i<arguments.length; i++) {
        args.push(arguments[i]);
        if (arguments[i])
            s += arguments[i].toString()+' ';
    }
    if (typeof this.mLog === 'undefined')
        this.mLog = [];
    this.mLog.push({level: aMsgLevel, msg: s});
    return args;
};

MyGlobalClassWithLogMethods.prototype.log = function() {
    var args = ['log'].concat(Array.prototype.slice.call(arguments));
    return this.debugLog.apply(this,args);
};

MyGlobalClassWithLogMethods.prototype.debug = function() {
    var args = ['debug'].concat(Array.prototype.slice.call(arguments));
    return this.debugLog.apply(this,args);
};

MyGlobalClassWithLogMethods.prototype.info = function() {
    var args = ['info'].concat(Array.prototype.slice.call(arguments));
    return this.debugLog.apply(this,args);
};

MyGlobalClassWithLogMethods.prototype.warn = function() {
    var args = ['warn'].concat(Array.prototype.slice.call(arguments));
    return this.debugLog.apply(this,args);
};

MyGlobalClassWithLogMethods.prototype.error = function() {
    var args = ['error'].concat(Array.prototype.slice.call(arguments));
    return this.debugLog.apply(this,args);
};

//not necessary, but it is used in my example code, so defining it
MyGlobalClassWithLogMethods.prototype.toString = function() {
    return "app: " + JSON.stringify(this);
};

Next, we put those methods to use like so:

//JS line done as early as possible so rest of app can use logging mechanism
window.app = new MyGlobalClassWithLogMethods();

//only way to get "line info" reliably as well as log the msg for actual page display;
//  ugly, but works. Any number of params accepted, and any kind of var will get
//  converted to str using .toString() method.
console.log.apply(console,app.log('the log msg'));
console.debug.apply(console,app.debug('the log msg','(debug)', app));
console.info.apply(console,app.info('the log msg','(info)'));
console.warn.apply(console,app.warn('the log msg','(warn)'));
console.error.apply(console,app.error('the log msg','(error)'));

Now the console gets log messages with their appropriate line information as well as our app contains an array of log messages that can be put to use. For example, to display your in-app log using HTML, JQuery and some CSS the following simplistic example can be used.

First, the HTML:

<div id="debug_area">
    <h4 class="text-center">Debug Log</h4>
    <ul id="log_list">
        <!-- console log/debug/info/warn/error ('msg') lines will go here -->
    </ul>
</div>

some CSS:

.log_level_log {
    color: black;
    background-color: white;
    font-size: x-small;
}
.log_level_debug {
    color: #060;
    background-color: #80FF80;
    font-size: x-small;
}
.log_level_info {
    color: #00F;
    background-color: #BEF;
    font-size: x-small;
}
.log_level_warn {
    color: #E65C00;
    background-color: #FB8;
    font-size: x-small;
}
.log_level_error {
    color: #F00;
    background-color: #FBB;
    font-size: x-small;
}

and some JQuery:

var theLog = app.mLog || [];
if (theLog.length>0) {
    var theLogList = $('#log_list');
    theLogList.empty();
    for (var i=0; i<theLog.length; i++) {
        theLogList.prepend($('<li class="log_level_'+theLog[i].level+'"></li>').text(theLog[i].msg));
    }
}

This is a simplistic use, but once you have the mechanism in place, you can do whatever your imagination can come up with, including leaving the log lines in the code, but setting a threshold so that only warnings and errors get through. Hopefully this helps others with their projects.

Uncle Code Monkey
  • 1,796
  • 1
  • 14
  • 23
0

Today you have to use args with rest operator, because as the Mozilla docs says Function.arguments has been deprecated and is not accessible in arrow functions. So simply you can extend it like below:

//#1
const myLog= (...args) =>
  console.log.bind(console, ...args);
//myLog("this is my new log")();
//#2
const myNewLog= (...args) =>{
 const prefix = "Prefixed: ";
 return console.log.bind(console, ...[prefix,...args]);
}
//myNewLog("test")()

And you can make a beautifulLog like this:

//#3
const colorizedLog = (text, color= "#40a7e3", ...args) =>
  console.log.bind(
    console,
    `%c ${text}`,
    `font-weight:bold; color:${color}`,
    ...args
  );
//colorizedLog("Title:", "#40a7e3", "This is a working example")();
user202729
  • 3,358
  • 3
  • 25
  • 36
SeyyedKhandon
  • 5,197
  • 8
  • 37
  • 68
0

This snippet apply a prefix to logs for all levels (console.log console.debug console.info ...) :

export const makeConsole = (context: string, cons = console): Console =>
  Object.getOwnPropertyNames(cons).reduce((c, lev) => {
    if (typeof cons[lev] === "function") {
      c[lev] = Function.prototype.bind.call(cons[lev], cons, context);
    }
    return c;
  }, {});

console.debug("Hello world!")
// >> Hello world!

console = makeConsole("[logging is fun]")
// >> [logging is fun] Hello world!

Bonus, for React peeps:

export function useConsole(context: string): Console {
  return React.useMemo(() => makeConsole(context), [context]);
}
Quentin Gaultier
  • 279
  • 6
  • 16
-1

Try setTimeout(console.log.bind(console,'foo'));

Gonzalo.-
  • 12,512
  • 5
  • 50
  • 82