console

控制台访问对象

全局对象。可用于提示信息，警告和错误记录。通过启动配置文件，可将日志定位 到不同的设备，以便于跟踪。日志支持格式化输出，例如：

console.log("%d + %d = %d", 100, 200, 100 + 200);

可以使用的格式化参数如下：

  • s - 字符串

  • d - 数字，包括整数和数字

  • j - 以 JSON 格式输出对象

  • %% - 输出字符 “ 本身

Field Summary

Type Method and Description
const public const FATALFATALFATAL

loglevel 级别常量
const public const ALERTALERTALERT

loglevel 级别常量
const public const CRITCRITCRIT

loglevel 级别常量
const public const ERRORERRORERROR

loglevel 级别常量
const public const WARNWARNWARN

loglevel 级别常量
const public const NOTICENOTICENOTICE

loglevel 级别常量
const public const INFOINFOINFO

loglevel 级别常量
const public const DEBUGDEBUGDEBUG

loglevel 级别常量
const public const PRINTPRINTPRINT

loglevel 仅用于输出，信息输出后不换行，file 和 syslog 不保存此级别信息
const public const NOTSETNOTSETNOTSET

loglevel 级别常量
Integer public static Integer loglevelloglevelloglevel

输出级别，用以过滤输出信息，缺省为 NOTSET，全部输出。信息过滤之后才会输出给 add 设定的各个设备。
readonly TextColor public static readonly TextColor colorscolorscolors

终端输出颜色配置对象，详见 TextColor
readonly Integer public static readonly Integer widthwidthwidth

查询终端每行字符数
readonly Integer public static readonly Integer heightheightheight

查询终端行数

Method Summary

Type Method and Description
void add(Array cfg)

批量添加 console 输出系统，支持的设备为 console, syslog 和 file，最多可以添加 10 个输出
void add(Value cfg)

添加 console 输出系统，支持的设备为 console, syslog 和 file，最多可以添加 10 个输出
void reset()

初始化到缺省设置，只在 console 输出信息
void log(String fmt,...)

记录普通日志信息，与 info 等同
void log(...)

记录普通日志信息，与 info 等同
void debug(String fmt,...)

记录调试日志信息
void debug(...)

记录调试日志信息
void info(String fmt,...)

记录普通日志信息，与 log 等同
void info(...)

记录普通日志信息，与 log 等同
void notice(String fmt,...)

记录警告日志信息
void notice(...)

记录警告日志信息
void warn(String fmt,...)

记录警告日志信息
void warn(...)

记录警告日志信息
void error(String fmt,...)

记录错误日志信息
void error(...)

记录错误日志信息
void crit(String fmt,...)

记录关键错误日志信息
void crit(...)

记录关键错误日志信息
void alert(String fmt,...)

记录警报错误日志信息
void alert(...)

记录警报错误日志信息
void dir(Value obj)

用 JSON 格式输出对象
void time(String label)

启动一个计时器
void timeEnd(String label)

统计指定计时器的数值
void trace(String label)

输出当前调用堆栈
void assert(Value value,String msg)

断言测试，如果测试值为假，则报错
void print(String fmt,...)

向控制台输出格式化文本，输出内容不会记入日志系统，输出文本后不会自动换行，可连续输出
void print(...)

向控制台输出格式化文本，输出内容不会记入日志系统，输出文本后不会自动换行，可连续输出
void moveTo(Integer row,Integer column)

移动控制台光标到指定位置
void hideCursor()

隐藏控制台光标
void showCursor()

显示控制台光标
void clear()

清除控制台
void keyDown(String key,String modifier)

按下一个按键
void keyDown(String key,Array modifier)

按下一个按键
void keyUp(String key,String modifier)

松开一个按键
void keyUp(String key,Array modifier)

松开一个按键
void keyTap(String key,String modifier)

点击并松开一个按键
void keyTap(String key,Array modifier)

点击并松开一个按键
void typeString(String text)

输入一个字符串
void moveMouse(Integer x,Integer y)

移动鼠标到指定的位置
void mouseUp(String button)

按下一个鼠标键
void mouseDown(String button)

放开一个鼠标键
void clickMouse(String button,Boolean dbclick)

点击一个鼠标键
String readLine(String msg)

从控制台读取用户输入

Field Detail

FATAL

const public const FATALFATALFATAL

loglevel 级别常量

ALERT

const public const ALERTALERTALERT

loglevel 级别常量

CRIT

const public const CRITCRITCRIT

loglevel 级别常量

ERROR

const public const ERRORERRORERROR

loglevel 级别常量

WARN

const public const WARNWARNWARN

loglevel 级别常量

NOTICE

const public const NOTICENOTICENOTICE

loglevel 级别常量

INFO

const public const INFOINFOINFO

loglevel 级别常量

DEBUG

const public const DEBUGDEBUGDEBUG

loglevel 级别常量

PRINT

const public const PRINTPRINTPRINT

loglevel 仅用于输出，信息输出后不换行，file 和 syslog 不保存此级别信息

NOTSET

const public const NOTSETNOTSETNOTSET

loglevel 级别常量

loglevel

Integer public static Integer loglevelloglevelloglevel

输出级别，用以过滤输出信息，缺省为 NOTSET，全部输出。信息过滤之后才会输出给 add 设定的各个设备。

colors

readonly TextColor public static readonly TextColor colorscolorscolors

终端输出颜色配置对象，详见 TextColor

width

readonly Integer public static readonly Integer widthwidthwidth

查询终端每行字符数

height

readonly Integer public static readonly Integer heightheightheight

查询终端行数

Method Detail

add

void add(Array cfg)

批量添加 console 输出系统，支持的设备为 console, syslog 和 file，最多可以添加 10 个输出

通过配置 console，可以将程序输出和系统错误发往不同设备，用于运行环境信息收集。

console.add(["console", {
   type: "syslog",
   levels: [console.INFO, console.ERROR]
}]);

Parameters

  • cfg 输出配置数组
add

void add(Value cfg)

添加 console 输出系统，支持的设备为 console, syslog 和 file，最多可以添加 10 个输出

通过配置 console，可以将程序输出和系统错误发往不同设备，用于运行环境信息收集。

cfg 为配置，可以为设备名称字符串：

console.add("console");

也可以为一个设备配置对象：

console.add({
   type: "console",
   levels: [console.INFO, console.ERROR]  // 选项，省略则输出全部级别日志
});

syslog 仅在 posix 平台有效：

console.add({
   type: "syslog",
   levels: [console.INFO, console.ERROR]
});

file 日志不支持简单调用：

console.add({
   type: "file",
   levels: [console.INFO, console.ERROR],
   path: "path/to/file",  // 必选项
   split: "30m",  // 选项，可选值为 "day", "hour", "minute", "###k", "###m", "###g"
   count: 10 // 选项，可选范围为 2-128，指定此项时必须提供 split
});

Parameters

  • cfg 输出配置
reset

void reset()

初始化到缺省设置，只在 console 输出信息

log

void log(String fmt,...)

记录普通日志信息，与 info 等同

记录一般等级的日志信息。通常用于输出非错误性提示信息。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

log

void log(...)

记录普通日志信息，与 info 等同

记录一般等级的日志信息。通常用于输出非错误性提示信息。

Parameters

  • ... 可选参数列表
debug

void debug(String fmt,...)

记录调试日志信息

记录调试日志信息。通常用于输出调试信息。不重要。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

debug

void debug(...)

记录调试日志信息

记录调试日志信息。通常用于输出调试信息。不重要。

Parameters

  • ... 可选参数列表
info

void info(String fmt,...)

记录普通日志信息，与 log 等同

记录一般等级的日志信息。通常用于输出非错误性提示信息。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

info

void info(...)

记录普通日志信息，与 log 等同

记录一般等级的日志信息。通常用于输出非错误性提示信息。

Parameters

  • ... 可选参数列表
notice

void notice(String fmt,...)

记录警告日志信息

记录警告日志信息。通常用于输出提示性调试信息。一般重要。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

notice

void notice(...)

记录警告日志信息

记录警告日志信息。通常用于输出提示性调试信息。一般重要。

Parameters

  • ... 可选参数列表
warn

void warn(String fmt,...)

记录警告日志信息

记录警告日志信息。通常用于输出警告性调试信息。重要。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

warn

void warn(...)

记录警告日志信息

记录警告日志信息。通常用于输出警告性调试信息。重要。

Parameters

  • ... 可选参数列表
error

void error(String fmt,...)

记录错误日志信息

记录用于错误日志信息。通常用于输出错误信息。非常重要。系统的出错信息也会以此等级记录。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

error

void error(...)

记录错误日志信息

记录用于错误日志信息。通常用于输出错误信息。非常重要。系统的出错信息也会以此等级记录。

Parameters

  • ... 可选参数列表
crit

void crit(String fmt,...)

记录关键错误日志信息

记录用于关键错误日志信息。通常用于输出关键错误信息。非常重要。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

crit

void crit(...)

记录关键错误日志信息

记录用于关键错误日志信息。通常用于输出关键错误信息。非常重要。

Parameters

  • ... 可选参数列表
alert

void alert(String fmt,...)

记录警报错误日志信息

记录用于警报错误日志信息。通常用于输出警报错误信息。非常重要。为最高级别信息。

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

alert

void alert(...)

记录警报错误日志信息

记录用于警报错误日志信息。通常用于输出警报错误信息。非常重要。为最高级别信息。

Parameters

  • ... 可选参数列表
dir

void dir(Value obj)

用 JSON 格式输出对象

Parameters

  • obj 给定要显示的对象
time

void time(String label)

启动一个计时器

Parameters

  • label 标题，缺省为空字符串。
timeEnd

void timeEnd(String label)

统计指定计时器的数值

Parameters

  • label 标题，缺省为空字符串。
trace

void trace(String label)

输出当前调用堆栈

通过日志输出当前调用堆栈。

Parameters

  • label 标题，缺省为空字符串。
assert

void assert(Value value,String msg)

断言测试，如果测试值为假，则报错

Parameters

  • value 测试的数值

  • msg 报错信息

print

void print(String fmt,...)

向控制台输出格式化文本，输出内容不会记入日志系统，输出文本后不会自动换行，可连续输出

Parameters

  • fmt 格式化字符串

  • ... 可选参数列表

print

void print(...)

向控制台输出格式化文本，输出内容不会记入日志系统，输出文本后不会自动换行，可连续输出

Parameters

  • ... 可选参数列表
moveTo

void moveTo(Integer row,Integer column)

移动控制台光标到指定位置

Parameters

  • row 指定新光标的行坐标

  • column 指定新光标的列坐标

hideCursor

void hideCursor()

隐藏控制台光标

showCursor

void showCursor()

显示控制台光标

clear

void clear()

清除控制台

keyDown

void keyDown(String key,String modifier)

按下一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键，可以为：control, alt, shift, command

keyDown

void keyDown(String key,Array modifier)

按下一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键数组，可以为：control, alt, shift, command

keyUp

void keyUp(String key,String modifier)

松开一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键，可以为：control, alt, shift, command

keyUp

void keyUp(String key,Array modifier)

松开一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键数组，可以为：control, alt, shift, command

keyTap

void keyTap(String key,String modifier)

点击并松开一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键，可以为：control, alt, shift, command

keyTap

void keyTap(String key,Array modifier)

点击并松开一个按键

Parameters

  • key 指定按键，单字符直接传入，功能键传入名称：

  • 功能键：f1 - f12

  • 方向键：up, down,left, right, home, end, pageup, pagedown

  • 编辑键：backspace, delete, insert, enter, tab, escape, space

  • 控制键：control, alt, shift, command

  • modifier 指定控制键数组，可以为：control, alt, shift, command

typeString

void typeString(String text)

输入一个字符串

Parameters

  • text 指定输入的字符串
moveMouse

void moveMouse(Integer x,Integer y)

移动鼠标到指定的位置

Parameters

  • x 指定 x 坐标

  • y 指定 y 坐标

mouseUp

void mouseUp(String button)

按下一个鼠标键

Parameters

  • button 指定鼠标键名称，允许值为: left, right, moddle
mouseDown

void mouseDown(String button)

放开一个鼠标键

Parameters

  • button 指定鼠标键名称，允许值为: left, right, moddle
clickMouse

void clickMouse(String button,Boolean dbclick)

点击一个鼠标键

Parameters

  • button 指定鼠标键名称，允许值为: left, right, moddle

  • dbclick 指定是否双击，缺省为 false

readLine

String readLine(String msg)

从控制台读取用户输入

Parameters

  • msg 提示信息

Returns

返回用户输入的信息