モジュールコンソール

コンソールアクセスオブジェクト

コンソールモジュールは、ブラウザのコンソールオブジェクトと同様の機能を提供するコアモジュールで、デバッグを容易にするための情報をコンソールに出力したり、情報を出力したりすることができます。

コンソールモジュールで最も一般的に使用されるメソッドは log() です。これは、任意の JavaScript 値をコンソールに出力し、自動的に改行を追加します。log() メソッドの他に、情報、警告、エラーを出力する info()、warn()、error() メソッドがあり、基本的には log() と同じ機能です。コンソールに表示されるスタイルを除くメソッド。

コンソールモジュールは、オブジェクトのプロパティとメソッドをより読みやすい形式でコンソールに出力するために使用される dir() メソッドも提供し、複雑なオブジェクトのデバッグを容易にします。さらに、コンソールでコードの実行のタイミングを計り、時間差を出力するための time() メソッドと timeEnd() メソッドがあります。

上記の一般的に使用されるメソッドに加えて、コンソールモジュールは次のような他のメソッドも提供します。assert()、notice()、trace() などを使用すると、さまざまな状況でのデバッグや情報出力が容易になります。

コンソールモジュールは、開発プロセス中のデバッグ効率を向上させ、さまざまな情報を便利かつ迅速に出力できる非常に実用的なモジュールです。

静的関数

add

コンソール出力システムを追加します。サポートされているデバイスは、コンソール、syslog、およびイベントです。最大 10 個の出力を追加できます。

1
static console.add(String type);

呼び出しパラメータ:

type: 文字列、出力デバイス

コンソールを設定することにより、プログラム出力とシステムエラーをさまざまなデバイスに送信して、実行環境情報を収集できます。

type は設定であり、はデバイス名の文字列です。

1
console.add("console");

syslog は posix プラットフォームでのみ有効です。

1
console.add("syslog");

イベントは Windows プラットフォームでのみ有効です。

1
console.add("event");

コンソール出力システムを追加します。サポートされているデバイスは、コンソール、syslog、イベント、ファイルです。最大 10 個の出力を追加できます。

1
static console.add(Object cfg);

呼び出しパラメータ:

cfg: オブジェクト、出力構成

コンソールを設定することにより、プログラム出力とシステムエラーをさまざまなデバイスに送信して、実行環境情報を収集できます。

cfg はデバイスのオブジェクトを構成できます。

1
2
3
4
console.add({
    type: "console",
    levels: [console.INFO, console.ERROR] // optional, default is all levels
});

syslog は posix プラットフォームでのみ有効です。

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

イベントは Windows プラットフォームでのみ有効です。

1
2
3
4
console.add({
    type: "event",
    levels: [console.INFO, console.ERROR]
});

ファイルログ:

1
2
3
4
5
6
7
console.add({
    type: "file",
    levels: [console.INFO, console.ERROR],
    path: "path/to/file_%s.log", // specifies the log output file, can use %s to specify the insertion date location, or add at the end if not specified
    split: "30m", // Optional values are "day", "hour", "minute", "####k", "####m", "####g", default is "1m"
    count: 10 // option, selectable from 2 to 128, default is 128
});

コンソール出力システムをバッチで追加します。サポートされているデバイスは、コンソール、syslog、イベント、ファイルです。最大 10 個の出力を追加できます。

1
static console.add(Array cfg);

呼び出しパラメータ:

cfg: 配列、出力構成配列

コンソールを設定することにより、プログラム出力とシステムエラーをさまざまなデバイスに送信して、実行環境情報を収集できます。

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

reset

デフォルト設定に初期化し、コンソールに情報のみを出力します。

1
static console.reset();

log

info に相当する共通のログ情報を記録します。

1
2
static console.log(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

一般レベルのログ情報を記録します。通常、エラー以外のプロンプト情報を出力するために使用されます。

info に相当する共通のログ情報を記録します。

1
static console.log(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

一般レベルのログ情報を記録します。通常、エラー以外のプロンプト情報を出力するために使用されます。

debug

デバッグログ情報を記録する

1
2
static console.debug(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

デバッグログ情報を記録します。通常、デバッグ情報を出力するために使用されます。重要ではない。

デバッグログ情報を記録する

1
static console.debug(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

デバッグログ情報を記録します。通常、デバッグ情報を出力するために使用されます。重要ではない。

info

ログに相当する共通のログ情報を記録します。

1
2
static console.info(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

一般レベルのログ情報を記録します。通常、エラー以外のプロンプト情報を出力するために使用されます。

ログに相当する共通のログ情報を記録します。

1
static console.info(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

一般レベルのログ情報を記録します。通常、エラー以外のプロンプト情報を出力するために使用されます。

notice

警告ログ情報を記録する

1
2
static console.notice(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

警告ログ情報を記録します。通常、有益なデバッグ情報を出力するために使用されます。一般的に重要です。

警告ログ情報を記録する

1
static console.notice(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

警告ログ情報を記録します。通常、有益なデバッグ情報を出力するために使用されます。一般的に重要です。

warn

警告ログ情報を記録する

1
2
static console.warn(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

警告ログ情報を記録します。通常、警告デバッグ情報を出力するために使用されます。重要。

警告ログ情報を記録する

1
static console.warn(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

警告ログ情報を記録します。通常、警告デバッグ情報を出力するために使用されます。重要。

error

エラーログ情報を記録する

1
2
static console.error(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

エラーログの情報を記録します。通常、エラーメッセージを出力するために使用されます。とても重要です。システムエラーメッセージもこのレベルで記録されます。

エラーログ情報を記録する

1
static console.error(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

crit

キーエラーログ情報を記録する

1
2
static console.crit(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

重大なエラーのログ情報。通常、重大なエラー情報を出力するために使用されます。とても重要です。

キーエラーログ情報を記録する

1
static console.crit(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

重大なエラーのログ情報。通常、重大なエラー情報を出力するために使用されます。とても重要です。

alert

アラートエラーログ情報を記録する

1
2
static console.alert(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

アラートのエラーログメッセージを記録します。通常、警告エラーメッセージを出力するために使用されます。とても重要です。は最高レベルの情報です。

アラートエラーログ情報を記録する

1
static console.alert(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

trace

現在のコールスタックを出力します

1
2
static console.trace(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

現在の呼び出しスタックをログを通じて出力します。

現在のコールスタックを出力します

1
static console.trace(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

現在の呼び出しスタックをログを通じて出力します。

dir

オブジェクトをJSON形式で出力する

1
2
static console.dir(Value obj,
    Object options = {});

呼び出しパラメータ:

obj: 値、処理するオブジェクトを指定します
options: オブジェクト、形式制御オプションを指定します

次のパラメータがサポートされています。

1
2
3
4
5
6
7
8
9{
    "colors": false, // specify if output should be colorized, defaults to false
    "depth": 2, // specify the max depth of the output, defaults to 2
    "table": false, // specify if output should be a table, defaults to false
    "encode_string": true, // specify if string should be encoded, defaults to true
    "maxArrayLength": 100, // specify max number of array elements to show, set to 0 or negative to show no elements, defaults to 100
    "maxStringLength": 10000, // specify max string length to output, set to 0 or negative to show no strings, defaults to 10000
    "fields": [], // specify the fields to be displayed, defaults to all
}

table

オブジェクトをJSON形式で出力する

1
static console.table(Value obj);

呼び出しパラメータ:

obj: 表示されるオブジェクトを指定した値

オブジェクトをJSON形式で出力する

1
2
static console.table(Value obj,
    Array fields);

呼び出しパラメータ:

obj: 表示されるオブジェクトを指定した値
fields: 表示されるフィールドを指定した配列

time

タイマーを開始する

1
static console.time(String label = "time");

呼び出しパラメータ:

label: 文字列、タイトル、デフォルトは空の文字列です。

timeElapse

指定されたタイマーの現在のタイミング値を出力します

1
static console.timeElapse(String label = "time");

呼び出しパラメータ:

label: 文字列、タイトル、デフォルトは空の文字列です。

timeEnd

指定されたタイマーを終了し、最後の時刻値を出力します

1
static console.timeEnd(String label = "time");

呼び出しパラメータ:

label: 文字列、タイトル、デフォルトは空の文字列です。

assert

アサーションテスト。テスト値が false の場合、エラーが報告されます。

1
2
static console.assert(Value value,
    String msg = "");

呼び出しパラメータ:

value: 値、テストする値
msg: 文字列、エラーメッセージ

print

フォーマットされたテキストをコンソールに出力します。出力内容はログシステムに記録されません。テキストは出力後に自動的に折り返されず、継続的に出力できます。

1
2
static console.print(String fmt,
    ...args);

呼び出しパラメータ:

fmt: 文字列、フォーマット文字列
args: ...、オプションのパラメータリスト

1
static console.print(...args);

呼び出しパラメータ:

args: ...、オプションのパラメータリスト

moveTo

コンソールカーソルを指定した位置に移動します

1
2
static console.moveTo(Integer row,
    Integer column);

呼び出しパラメータ:

row: 整数、新しいカーソルの行座標を指定します
column: 整数、新しいカーソルの列座標を指定します

hideCursor

コンソールカーソルを隠す

1
static console.hideCursor();

showCursor

コンソールカーソルを表示

1
static console.showCursor();

clear

クリアコンソール

1
static console.clear();

readLine

コンソールからユーザー入力を読み取る

1
static String console.readLine(String msg = "") async;

呼び出しパラメータ:

msg: 文字列、プロンプトメッセージ

返される結果:

String、ユーザーが入力した情報を返します。

getpass

ユーザーがコンソールから入力したパスワードを読み取ります

1
static String console.getpass(String msg = "") async;

呼び出しパラメータ:

msg: 文字列、プロンプトメッセージ

返される結果:

String、ユーザーが入力したパスワードを返します。

静的プロパティ

loglevel

整数、出力レベル。出力情報のフィルタリングに使用されます。デフォルトは NOTSET、すべて出力です。フィルタリング後の情報は、addで設定した各デバイスに出力されます。

1
static Integer console.loglevel;

width

整数、ターミナルの 1 行あたりの文字数をクエリします。

1
static readonly Integer console.width;

height

整数、端子の回線数を問い合わせる

1
static readonly Integer console.height;

絶え間ない

FATAL

ログレベルのレベル定数

1
const console.FATAL = 0;

ALERT

ログレベルのレベル定数

1
const console.ALERT = 1;

CRIT

ログレベルのレベル定数

1
const console.CRIT = 2;

ERROR

ログレベルのレベル定数

1
const console.ERROR = 3;

WARN

ログレベルのレベル定数

1
const console.WARN = 4;

NOTICE

ログレベルのレベル定数

1
const console.NOTICE = 5;

INFO

ログレベルのレベル定数

1
const console.INFO = 6;

DEBUG

ログレベルのレベル定数

1
const console.DEBUG = 7;

PRINT

loglevel は出力のみに使用されます。情報の出力後に改行はありません。ファイルおよび syslog にはこのレベルの情報は保存されません。

1
const console.PRINT = 9;

NOTSET

ログレベルのレベル定数

1
const console.NOTSET = 10;

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティモジュール

モジュールコンソール

静的関数

add

reset

log

debug

info

notice

warn

error

crit

alert

trace

dir

table

time

timeElapse

timeEnd

assert

print

moveTo

hideCursor

showCursor

clear

readLine

getpass

静的プロパティ

loglevel

width

height

絶え間ない

FATAL

ALERT

CRIT

ERROR

WARN

NOTICE

INFO

DEBUG

PRINT

NOTSET