I understand it is a best practice in angular to use $log
instead of console.log
.
However, I can't find good documentation explaining the reasons. Why should a developer use $log
?
2 Answers
$log
first checks if the browser supports console.log
(IE 8, for example, doesn't). This prevents errors being displayed on IE 8. Note: this doesn't mean it will log anything on IE 8, it simply means it won't throw the error.
Next to that, it also allows you to decorate and mock $log
for extending and testing purposes, if you are so inclined. You could for example decorate it to log to an array for IE 8 support.
A bonus feature: if you pass it a JavaScript Error
instance, it will attempt to format it nicely. This can be found out by reading the source code.
EDIT: "It is not that IE 8 doesn't support console.log. It just doesn't create the console object until the dev tools are opened." See comments below for more details.
-
2Thanks. Especially for directing me to the source code. I'm learning that's frequently the place to go. Jun 12, 2014 at 14:40
-
9
-
61Using $log has a downside as well: if you use console.log you can see the file and the line number of the actual logging. With $log it will always show angular.js as the source of the log in your console.– wvdzOct 26, 2014 at 9:42
-
3
-
19Another bonus, it allows you to turn off debug logging in production, with $logProvider.debugEnabled(false);– JimJtyMar 23, 2016 at 22:36
Just to complete @Steve's answer (which is correct), $log
also has the advantage of being turned off. Using this code you can disable the logging from $log
:
app.config(function($logProvider) {
$logProvider.debugEnabled(true);
});
This is very handy if you want to disable all logs at once, rather than delete them line by line manually.
-
1This will only turn off $log.debug(), but not the other log-levels. Feb 21, 2019 at 12:35
-
Thats a good point, for what use are your log ? i think debug should be the most used one, the others to bring more information when its really needed. Nov 13, 2019 at 18:18