Class console
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
console
Class ini memungkinkan developer menulis ke log Eksekusi dan ke Google Cloud Logging jika skrip dikaitkan dengan Project Cloud standar.
Untuk dukungan penuh Cloud Logging dan logging terstruktur, gunakan Logger
. Metode console
melakukan serialisasi objek ke string dan tidak mendukung jsonPayload
sebagai bagian dari logging terstruktur
LogEntry
.
function measuringExecutionTime() {
const label = "myFunction() time"; // Labels the timing log entry.
console.time(label); // Starts the timer.
try {
myFunction(); // Function to time.
} catch (e) {
// Logs an ERROR message.
console.error("myFunction() yielded an error: " + e);
}
console.timeEnd(label); // Stops the timer, logs execution duration.
}
function myFunction() {
// ...
}
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
error() | void | Menghasilkan pesan level ERROR kosong ke Stackdriver Logging. |
error(formatOrObject, values) | void | Menghasilkan pesan level ERROR ke Stackdriver Logging. |
info() | void | Menghasilkan pesan level INFO kosong ke Stackdriver Logging. |
info(formatOrObject, values) | void | Menghasilkan pesan level INFO ke Stackdriver Logging. |
log() | void | Menghasilkan pesan level DEBUG kosong ke Stackdriver Logging. |
log(formatOrObject, values) | void | Menghasilkan pesan level DEBUG ke Stackdriver Logging. |
time(label) | void | Memulai timer yang dapat Anda gunakan untuk melacak berapa lama operasi berlangsung. |
timeEnd(label) | void | Menghentikan timer yang sebelumnya dimulai dengan memanggil console.time() . |
warn() | void | Menghasilkan pesan level PERINGATAN kosong ke Stackdriver Logging. |
warn(formatOrObject, values) | void | Menghasilkan pesan level PERINGATAN ke Stackdriver Logging. |
Dokumentasi mendetail
error()
Menghasilkan pesan level ERROR kosong ke Stackdriver Logging.
Menghasilkan pesan level ERROR ke Stackdriver Logging.
Parameter
Nama | Jenis | Deskripsi |
formatOrObject | Object | string yang berisi nol atau beberapa string penggantian, atau objek JavaScript yang akan dicatat ke dalam log sebagai objek JavaScript jika tidak ada parameter lain. |
values | Object... | objek yang akan digunakan untuk mengganti string penggantian dalam pesan. Hal ini memberi
Anda kontrol tambahan atas format output. |
info()
Menghasilkan pesan level INFO kosong ke Stackdriver Logging.
Menghasilkan pesan level INFO ke Stackdriver Logging.
Parameter
Nama | Jenis | Deskripsi |
formatOrObject | Object | string yang berisi nol atau beberapa string penggantian, atau objek JavaScript yang akan dicatat ke dalam log sebagai objek JavaScript jika tidak ada parameter lain. |
values | Object... | objek yang akan digunakan untuk mengganti string penggantian dalam pesan. Hal ini memberi
Anda kontrol tambahan atas format output. |
log()
Menghasilkan pesan level DEBUG kosong ke Stackdriver Logging.
Menghasilkan pesan level DEBUG ke Stackdriver Logging.
Parameter
Nama | Jenis | Deskripsi |
formatOrObject | Object | string yang berisi nol atau beberapa string penggantian, atau objek JavaScript yang akan dicatat ke dalam log sebagai objek JavaScript jika tidak ada parameter lain. |
values | Object... | objek yang akan digunakan untuk mengganti string penggantian dalam pesan. Hal ini memberi
Anda kontrol tambahan atas format output. |
time(label)
Memulai timer yang dapat Anda gunakan untuk melacak berapa lama operasi berlangsung.
Parameter
Nama | Jenis | Deskripsi |
label | String | Nama yang akan diberikan ke timer baru. |
timeEnd(label)
Menghentikan timer yang sebelumnya dimulai dengan memanggil console.time()
. Durasi waktu
dicatat dalam log di Stackdriver.
Parameter
Nama | Jenis | Deskripsi |
label | String | nama timer yang akan dihentikan. |
warn()
Menghasilkan pesan level PERINGATAN kosong ke Stackdriver Logging.
Menghasilkan pesan level PERINGATAN ke Stackdriver Logging.
Parameter
Nama | Jenis | Deskripsi |
formatOrObject | Object | string yang berisi nol atau beberapa string penggantian, atau objek JavaScript yang akan dicatat ke dalam log sebagai objek JavaScript jika tidak ada parameter lain. |
values | Object... | objek yang akan digunakan untuk mengganti string penggantian dalam pesan. Hal ini memberi
Anda kontrol tambahan atas format output. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eThe \u003ccode\u003econsole\u003c/code\u003e class enables developers to write logs to Google Cloud's Stackdriver Logging service with various severity levels (DEBUG, INFO, ERROR, WARNING).\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods like \u003ccode\u003econsole.log()\u003c/code\u003e, \u003ccode\u003econsole.info()\u003c/code\u003e, \u003ccode\u003econsole.error()\u003c/code\u003e, and \u003ccode\u003econsole.warn()\u003c/code\u003e for logging messages with different severity.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use \u003ccode\u003econsole.time()\u003c/code\u003e and \u003ccode\u003econsole.timeEnd()\u003c/code\u003e to measure the execution time of specific code blocks.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econsole\u003c/code\u003e methods accept format strings and values for structured logging, allowing objects and other data types to be included in log entries.\u003c/p\u003e\n"],["\u003cp\u003eLog entries can be viewed and analyzed in the Stackdriver Logging interface for debugging and monitoring purposes.\u003c/p\u003e\n"]]],[],null,["# Class console\n\nconsole\n\nThis class allows the developer to write to the Execution log and to [Google Cloud Logging](https://cloud.google.com/logging) if the script is associated with\na [standard\nCloud Project](https://developers.google.com/apps-script/guides/cloud-platform-projects#standard).\n\nFor full support of Cloud Logging and structured logging, use [Logger](/apps-script/reference/base/logger). The `console` methods\nserialize the objects to strings and do not support `json``Payload` as part of the structured\nlogging [`Log``Entry`](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry).\n\n```javascript\nfunction measuringExecutionTime() {\n const label = \"myFunction() time\"; // Labels the timing log entry.\n console.time(label); // Starts the timer.\n try {\n myFunction(); // Function to time.\n } catch (e) {\n // Logs an ERROR message.\n console.error(\"myFunction() yielded an error: \" + e);\n }\n console.timeEnd(label); // Stops the timer, logs execution duration.\n}\n\nfunction myFunction() {\n // ...\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------------|-------------|------------------------------------------------------------------------|\n| [error()](#error()) | `void` | Outputs a blank ERROR level message to Stackdriver Logging. |\n| [error(formatOrObject, values)](#error(Object,Object...)) | `void` | Outputs an ERROR level message to Stackdriver Logging. |\n| [info()](#info()) | `void` | Outputs blank INFO level message to Stackdriver Logging. |\n| [info(formatOrObject, values)](#info(Object,Object...)) | `void` | Outputs an INFO level message to Stackdriver Logging. |\n| [log()](#log()) | `void` | Outputs a blank DEBUG level message to Stackdriver Logging. |\n| [log(formatOrObject, values)](#log(Object,Object...)) | `void` | Outputs a DEBUG level message to Stackdriver Logging. |\n| [time(label)](#time(String)) | `void` | Starts a timer you can use to track how long an operation takes. |\n| [timeEnd(label)](#timeEnd(String)) | `void` | Stops a timer that was previously started by calling `console.time()`. |\n| [warn()](#warn()) | `void` | Outputs a blank WARNING level message to Stackdriver Logging. |\n| [warn(formatOrObject, values)](#warn(Object,Object...)) | `void` | Outputs a WARNING level message to Stackdriver Logging. |\n\nDetailed documentation\n----------------------\n\n### `error()`\n\nOutputs a blank ERROR level message to Stackdriver Logging.\n\n*** ** * ** ***\n\n### `error(formatOrObject, values)`\n\nOutputs an ERROR level message to Stackdriver Logging.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `format``Or``Object` | `Object` | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |\n| `values` | `Object...` | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |\n\n*** ** * ** ***\n\n### `info()`\n\nOutputs blank INFO level message to Stackdriver Logging.\n\n*** ** * ** ***\n\n### `info(formatOrObject, values)`\n\nOutputs an INFO level message to Stackdriver Logging.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `format``Or``Object` | `Object` | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |\n| `values` | `Object...` | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |\n\n*** ** * ** ***\n\n### `log()`\n\nOutputs a blank DEBUG level message to Stackdriver Logging.\n\n*** ** * ** ***\n\n### `log(formatOrObject, values)`\n\nOutputs a DEBUG level message to Stackdriver Logging.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `format``Or``Object` | `Object` | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |\n| `values` | `Object...` | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |\n\n*** ** * ** ***\n\n### `time(label)`\n\nStarts a timer you can use to track how long an operation takes.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|---------------------------------|\n| `label` | `String` | The name to give the new timer. |\n\n*** ** * ** ***\n\n### `time``End(label)`\n\nStops a timer that was previously started by calling `console.time()`. The time duration\nis logged in Stackdriver.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|--------------------------------|\n| `label` | `String` | the name of the timer to stop. |\n\n*** ** * ** ***\n\n### `warn()`\n\nOutputs a blank WARNING level message to Stackdriver Logging.\n\n*** ** * ** ***\n\n### `warn(formatOrObject, values)`\n\nOutputs a WARNING level message to Stackdriver Logging.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `format``Or``Object` | `Object` | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |\n| `values` | `Object...` | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |"]]