console: add support for console.debug

Adds the console.debug() method, alias for console.log(). This method is
exposed by V8 and was only available in inspector until now. Also adds
matching test and documentation.

PR-URL: #17033
Refs: #17004
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Khaidi Chu <[email protected]>
Reviewed-By: Michaël Zasso <[email protected]>
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: Timothy Gu <[email protected]>
Reviewed-By: James M Snell <[email protected]>

Author: Tiriel

doc/api/console.md

@@ -237,6 +237,15 @@ undefined
 >
 ```
 
+### console.debug(data[, ...args])
+<!-- YAML
+added: v8.0.0
+-->
+* `data` {any}
+* `...args` {any}
+
+The `console.debug()` function is an alias for [`console.log()`][].
+
 ### console.dir(obj[, options])
 <!-- YAML
 added: v0.1.101

lib/console.js

@@ -133,6 +133,9 @@ Console.prototype.log = function log(...args) {
 };
 
 
+Console.prototype.debug = Console.prototype.log;
+
+
 Console.prototype.info = Console.prototype.log;
 
 

test/parallel/test-console.js

@@ -61,6 +61,13 @@ console.log('%s %s', 'foo', 'bar', 'hop');
 console.log({ slashes: '\\\\' });
 console.log(custom_inspect);
 
+// test console.debug() goes to stdout
+console.debug('foo');
+console.debug('foo', 'bar');
+console.debug('%s %s', 'foo', 'bar', 'hop');
+console.debug({ slashes: '\\\\' });
+console.debug(custom_inspect);
+
 // test console.info() goes to stdout
 console.info('foo');
 console.info('foo', 'bar');
@@ -132,6 +139,10 @@ for (const expected of expectedStrings) {
   assert.strictEqual(errStrings.shift(), `${expected}\n`);
 }
 
+for (const expected of expectedStrings) {
+  assert.strictEqual(strings.shift(), `${expected}\n`);
+}
+
 assert.strictEqual(strings.shift(),
                    "{ foo: 'bar', inspect: [Function: inspect] }\n");
 assert.strictEqual(strings.shift(),