Class console
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
console
Mit dieser Klasse kann der Entwickler in das Ausführungsprotokoll und in Google Cloud Logging schreiben, wenn das Script mit einem Standard-Cloud-Projekt verknüpft ist.
Für die vollständige Unterstützung von Cloud Logging und strukturiertem Logging verwenden Sie Logger. Die console-Methoden serialisieren die Objekte in Strings und unterstützen jsonPayload nicht als Teil des strukturierten Loggings 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() {
// ...
}
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
error() | void | Gibt eine leere Nachricht der ERROR-Ebene an Stackdriver Logging aus. |
error(formatOrObject, values) | void | Gibt eine Nachricht der ERROR-Ebene an Stackdriver Logging aus. |
info() | void | Gibt eine leere Nachricht der INFO-Ebene an Stackdriver Logging aus. |
info(formatOrObject, values) | void | Gibt eine Nachricht der INFO-Ebene an Stackdriver Logging aus. |
log() | void | Gibt eine leere DEBUG-Ebene an Stackdriver Logging aus. |
log(formatOrObject, values) | void | Gibt eine DEBUG-Ebene-Nachricht an Stackdriver Logging aus. |
time(label) | void | Startet einen Timer, mit dem Sie die Dauer eines Vorgangs messen können. |
timeEnd(label) | void | Beendet einen Timer, der zuvor durch Aufrufen von console.time() gestartet wurde. |
warn() | void | Ergibt eine leere Nachricht der WARNUNGSebene in Stackdriver Logging. |
warn(formatOrObject, values) | void | Gibt eine Nachricht der WARNUNGS-Ebene an Stackdriver Logging aus. |
Detaillierte Dokumentation
error()
Gibt eine leere Nachricht der ERROR-Ebene an Stackdriver Logging aus.
Gibt eine Nachricht der ERROR-Ebene an Stackdriver Logging aus.
Parameter
| Name | Typ | Beschreibung |
formatOrObject | Object | Ein String mit null oder mehr Substitutionsstrings oder ein JavaScript-Objekt, das als JavaScript-Objekt protokolliert wird, wenn keine anderen Parameter vorhanden sind. |
values | Object... | Objekte, durch die die Ersetzungsstrings in der Nachricht ersetzt werden sollen. So haben Sie mehr Kontrolle über das Ausgabeformat. |
info()
Gibt eine leere Nachricht der INFO-Ebene an Stackdriver Logging aus.
Gibt eine Nachricht der INFO-Ebene an Stackdriver Logging aus.
Parameter
| Name | Typ | Beschreibung |
formatOrObject | Object | Ein String mit null oder mehr Substitutionsstrings oder ein JavaScript-Objekt, das als JavaScript-Objekt protokolliert wird, wenn keine anderen Parameter vorhanden sind. |
values | Object... | Objekte, durch die die Ersetzungsstrings in der Nachricht ersetzt werden sollen. So haben Sie mehr Kontrolle über das Ausgabeformat. |
log()
Gibt eine leere DEBUG-Ebene an Stackdriver Logging aus.
Gibt eine DEBUG-Ebene-Nachricht an Stackdriver Logging aus.
Parameter
| Name | Typ | Beschreibung |
formatOrObject | Object | Ein String mit null oder mehr Substitutionsstrings oder ein JavaScript-Objekt, das als JavaScript-Objekt protokolliert wird, wenn keine anderen Parameter vorhanden sind. |
values | Object... | Objekte, durch die die Ersetzungsstrings in der Nachricht ersetzt werden sollen. So haben Sie mehr Kontrolle über das Ausgabeformat. |
time(label)
Startet einen Timer, mit dem Sie die Dauer eines Vorgangs messen können.
Parameter
| Name | Typ | Beschreibung |
label | String | Der Name für den neuen Timer. |
timeEnd(label)
Beendet einen Timer, der zuvor durch Aufrufen von console.time() gestartet wurde. Die Zeitdauer wird in Stackdriver protokolliert.
Parameter
| Name | Typ | Beschreibung |
label | String | Der Name des Timers, der beendet werden soll. |
warn()
Ergibt eine leere Nachricht der WARNUNGSebene in Stackdriver Logging.
Gibt eine Nachricht der WARNUNGS-Ebene an Stackdriver Logging aus.
Parameter
| Name | Typ | Beschreibung |
formatOrObject | Object | Ein String mit null oder mehr Substitutionsstrings oder ein JavaScript-Objekt, das als JavaScript-Objekt protokolliert wird, wenn keine anderen Parameter vorhanden sind. |
values | Object... | Objekte, durch die die Ersetzungsstrings in der Nachricht ersetzt werden sollen. So haben Sie mehr Kontrolle über das Ausgabeformat. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
