Class console
Page Summary
The
consoleclass allows developers to write to the Execution log and Google Cloud Logging.Unlike the
Loggerclass,consolemethods serialize objects to strings and do not support structured logging withjsonPayload.The
consoleclass provides methods for logging messages at different levels, includingerror(),info(),log(), andwarn().The
consoleclass also includestime()andtimeEnd()methods for measuring execution time.
This class allows the developer to write to the Execution log and toGoogle Cloud Logging if the script is associated withastandardCloud Project.
For full support of Cloud Logging and structured logging, useLogger. Theconsole methodsserialize the objects to strings and do not supportjson as part of the structuredloggingLog.
functionmeasuringExecutionTime(){constlabel="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.}functionmyFunction(){// ...}
Methods
| Method | Return type | Brief description |
|---|---|---|
error() | void | Outputs a blank ERROR level message to Stackdriver Logging. |
error(formatOrObject, values) | void | Outputs an ERROR level message to Stackdriver Logging. |
info() | void | Outputs blank INFO level message to Stackdriver Logging. |
info(formatOrObject, values) | void | Outputs an INFO level message to Stackdriver Logging. |
log() | void | Outputs a blank DEBUG level message to Stackdriver Logging. |
log(formatOrObject, values) | void | Outputs a DEBUG level message to Stackdriver Logging. |
time(label) | void | Starts a timer you can use to track how long an operation takes. |
time | void | Stops a timer that was previously started by callingconsole.time(). |
warn() | void | Outputs a blank WARNING level message to Stackdriver Logging. |
warn(formatOrObject, values) | void | Outputs a WARNING level message to Stackdriver Logging. |
Detailed documentation
error()
Outputs a blank ERROR level message to Stackdriver Logging.
error(formatOrObject, values)
Outputs an ERROR level message to Stackdriver Logging.
Parameters
| Name | Type | Description |
|---|---|---|
format | Object | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |
values | Object... | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |
info()
Outputs blank INFO level message to Stackdriver Logging.
info(formatOrObject, values)
Outputs an INFO level message to Stackdriver Logging.
Parameters
| Name | Type | Description |
|---|---|---|
format | Object | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |
values | Object... | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |
log()
Outputs a blank DEBUG level message to Stackdriver Logging.
log(formatOrObject, values)
Outputs a DEBUG level message to Stackdriver Logging.
Parameters
| Name | Type | Description |
|---|---|---|
format | Object | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |
values | Object... | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |
time(label)
Starts a timer you can use to track how long an operation takes.
Parameters
| Name | Type | Description |
|---|---|---|
label | String | The name to give the new timer. |
timeEnd(label)
Stops a timer that was previously started by callingconsole.time(). The time durationis logged in Stackdriver.
Parameters
| Name | Type | Description |
|---|---|---|
label | String | the name of the timer to stop. |
warn()
Outputs a blank WARNING level message to Stackdriver Logging.
warn(formatOrObject, values)
Outputs a WARNING level message to Stackdriver Logging.
Parameters
| Name | Type | Description |
|---|---|---|
format | Object | a string containing zero or more substitution strings, or a JavaScript object to be logged as a JavaScript object if no other parameters. |
values | Object... | objects with which to replace substitution strings within the message. This gives you additional control over the format of the output. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.