【指令碼語言】【RINGO JS 】模組 console
模組 console
該模組提供了在標準輸出流 stdout 和錯誤流 stderr 上寫入錯誤記錄和快速除錯的功能。它與大多數 Web 瀏覽器中實現的控制檯物件類似。
Functions
- assert (expression, msg...)
- dir (obj)
- error (msg...)
- info (msg...)
- log (msg...)
- time (name)
- timeEnd (name)
- trace (msg...)
- warn
assert (expression, msg...)
測試表達式是否為真,如果不是,則引發 AssertionError 異常。它使用 ECMAScript toBoolean() 轉換。
Example
>> var x = 10;
>> console.assert(x > 0, 'failed!'); // passes
>> console.assert(x < 0, 'failed!'); // fails
AssertionError: failed! at <stdin>:12
>> console.assert(false, 'failed!'); // fails
AssertionError: failed! at <stdin>:13
>> // passes; any Object expression is true
>> console.assert(new Boolean(false), 'failed!');
Parameters
Boolean | expression | the expression to test |
*... | msg... | one or more error messages |
dir (obj)
在 stdout 上列印一個物件的所有屬性列表。
Example
>> var obj = { foo: "bar", baz: 12345 };
>> console.dir(obj);
{ foo: 'bar', baz: 12345 }
>> console.dir(global);
{ setTimeout: [Function], setInterval: [Function] }
Parameters
Object | obj | the object whose properties should be output |
error (msg...)
用可視的“錯誤”表示記錄訊息,包括呼叫程式碼的檔名和行號。列印在 stderr 上。
Example
>> console.error('Hello World!');
[error] Hello World! (<stdin>:1)
>> console.error('A: %s, B: %s, C: %s', 'a', 'b', 'c');
[error] A: a, B: b, C: c (<stdin>:3)
>> console.error('Current nanoseconds: %d', java.lang.System.nanoTime());
[error] Current nanoseconds: 9228448561643 (<stdin>:5)
Parameters
*... | msg... | one or more message arguments |
info (msg...)
用可視“資訊”表示記錄訊息,包括呼叫程式碼的檔名和行號。在標準輸出上列印。
Example
>> console.info('Hello World!');
[info] Hello World! (<stdin>:1)
>> console.info('A: %s, B: %s, C: %s', 'a', 'b', 'c');
[info] A: a, B: b, C: c (<stdin>:3)
>> console.info('Current nanoseconds: %d', java.lang.System.nanoTime());
[info] Current nanoseconds: 9677228481391 (<stdin>:5)
Parameters
*... | msg... | one or more message arguments |
log (msg...)
在 stdout 上將訊息記錄到控制檯。
日誌的第一個引數可能是一個包含類似 printf 的佔位符的字串。否則,multipel 引數將被連線在一起並以空格分隔。
Example
>> console.log('Hello World!');
Hello World!
>> console.log('A: %s, B: %s, C: %s', 'a', 'b', 'c');
A: a, B: b, C: c
>> console.log('Current nanoseconds: %d', java.lang.System.nanoTime());
Current nanoseconds: 9607196939209
Parameters
*... | msg... | one or more message arguments |
time (name)
以給定的名稱建立一個新的計時器。呼叫具有相同名稱的 console.timeEnd(name)來停止計時器並記錄已過去的時間。
Example
>> console.time('timer-1');
>> // Wait some time ...
>> console.timeEnd('timer-1');
timer-1: 15769ms
Parameters
String | name | the timer name |
timeEnd (name)
停止通過呼叫 console.time(name) 建立的計時器並記錄已用時間。
Example
>> console.time('timer-1');
>> // Wait some time ...
>> console.timeEnd('timer-1');
timer-1: 15769ms
Parameters
String | name | the timer name |
trace (msg...)
在呼叫 JavaScript 的位置列印 JavaScript 執行的堆疊跟蹤。在標準輸出上列印。
Parameters
*... | msg... | optional message arguments |
warn (msg...)
用可視的“警告”表示記錄訊息,包括呼叫程式碼的檔名和行號。列印在 stderr 上。
Example
>> console.warn('Hello World!');
[warn] Hello World! (<stdin>:1)
>> console.warn('A: %s, B: %s, C: %s', 'a', 'b', 'c');
[warn] A: a, B: b, C: c (<stdin>:3)
>> console.warn('Current nanoseconds: %d', java.lang.System.nanoTime());
[warn] Current nanoseconds: 9294672097821 (<stdin>:5)
Parameters
*... | msg... | one or more message arguments |