مرجع واجهة node:console

يعيد ⁦require("node:console")⁩ و⁦globalThis.console⁩ الكائن نفسه. وتصدّر الوحدة أيضًا ⁦Console⁩ للكتابة إلى تدفقات مخصّصة.

import console, { Console } from "node:console";

console.log("value=%d", 2);
console.table([{ a: 1, b: "x" }]);

const custom = new Console(process.stdout, process.stderr);
custom.warn("written to stderr");

التوابع المعتادة متاحة: ⁦log⁩ و⁦info⁩ و⁦warn⁩ و⁦error⁩ و⁦debug⁩ و⁦dir⁩ و⁦trace⁩ و⁦table⁩ و⁦assert⁩ و⁦clear⁩، والعدّادات والمجموعات والمؤقتات. ويدعم التنسيق ⁦%s⁩ و⁦%d⁩ و⁦%i⁩ و⁦%f⁩ و⁦%j⁩ و⁦%o⁩ و⁦%O⁩ و⁦%%⁩.

يدعم ⁦console.table⁩ المصفوفات والكائنات ويعرض جدول ⁦ASCII⁩. أما التباعد والمحاذاة فيه فيحددهما التنفيذ؛ فلا تحلّل النص المعروض.

استبدال ⁦process.stdout.write⁩ أو ⁦process.stderr.write⁩ يعترض أيضًا مخرجات ⁦console⁩ العامة المقابلة.

Reference

Status: Partial · 20 of 21 suite tests pass (95.2%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`log()`	function	Full	Prints to stdout with newline
`info()`	function	Full	Alias for log()
`warn()`	function	Full	Prints to stderr with newline
`error()`	function	Full	Prints to stderr with newline
`debug()`	function	Full	Prints to stdout with newline
`trace()`	function	Full	Prints to stderr the string ‘Trace: ’ followed by a stack trace
`dir()`	function	Full	Uses util.inspect() on obj and prints the resulting string to stdout
`dirxml()`	function	Full	Alias for log()
`table()`	function	Full	Prints a table representation of the data
`clear()`	function	Full	Clears the console (when possible)
`count()`	function	Full	Maintains an internal counter and outputs the number of times count() has been called with the given label
`countReset()`	function	Full	Resets the internal counter for the given label
`group()`	function	Full	Increases indentation of subsequent lines by spaces for grouping
`groupCollapsed()`	function	Full	Alias for group()
`groupEnd()`	function	Full	Decreases indentation of subsequent lines by spaces for grouping
`time()`	function	Full	Starts a timer with a given label
`timeEnd()`	function	Full	Stops a timer and prints elapsed time
`timeLog()`	function	Full	Prints the elapsed time for a running timer without stopping it
`assert()`	function	Full	Writes an error message to the console if the assertion is false

Not implemented

context, createTask, profile, profileEnd, timeStamp.

Tests: node-api node:console: 20 pass, 1 fail, 0 error, 1 skipped. Failing: test-console-issue-43095.js.