Class console
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
console
Cette classe permet au développeur d'écrire dans le journal d'exécution et dans Google Cloud Logging si le script est associé à un projet Cloud standard.
Pour une compatibilité complète avec Cloud Logging et la journalisation structurée, utilisez Logger. Les méthodes console sérialisent les objets en chaînes et ne sont pas compatibles avec jsonPayload dans le cadre de la journalisation structurée 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() {
// ...
}
Méthodes
| Méthode | Type renvoyé | Brève description |
error() | void | Affiche un message vide de niveau ERROR dans Stackdriver Logging. |
error(formatOrObject, values) | void | Affiche un message de niveau ERROR dans Stackdriver Logging. |
info() | void | Affiche un message vide de niveau INFO dans Stackdriver Logging. |
info(formatOrObject, values) | void | Affiche un message de niveau INFO dans Stackdriver Logging. |
log() | void | Affiche un message vide de niveau DEBUG dans Stackdriver Logging. |
log(formatOrObject, values) | void | Affiche un message de niveau DEBUG dans Stackdriver Logging. |
time(label) | void | Démarre un minuteur que vous pouvez utiliser pour suivre la durée d'une opération. |
timeEnd(label) | void | Arrête un minuteur précédemment démarré en appelant console.time(). |
warn() | void | Affiche un message vide de niveau AVERTISSEMENT dans Stackdriver Logging. |
warn(formatOrObject, values) | void | Affiche un message de niveau AVERTISSEMENT dans Stackdriver Logging. |
Documentation détaillée
error()
Affiche un message vide de niveau ERROR dans Stackdriver Logging.
Affiche un message de niveau ERROR dans Stackdriver Logging.
Paramètres
| Nom | Type | Description |
formatOrObject | Object | une chaîne contenant zéro ou plusieurs chaînes de substitution, ou un objet JavaScript à consigner en tant qu'objet JavaScript si aucun autre paramètre n'est défini. |
values | Object... | objets à utiliser pour remplacer les chaînes de substitution dans le message. Vous pouvez ainsi contrôler davantage le format de la sortie. |
info()
Affiche un message vide de niveau INFO dans Stackdriver Logging.
Affiche un message de niveau INFO dans Stackdriver Logging.
Paramètres
| Nom | Type | Description |
formatOrObject | Object | une chaîne contenant zéro ou plusieurs chaînes de substitution, ou un objet JavaScript à consigner en tant qu'objet JavaScript si aucun autre paramètre n'est défini. |
values | Object... | objets à utiliser pour remplacer les chaînes de substitution dans le message. Vous pouvez ainsi contrôler davantage le format de la sortie. |
log()
Affiche un message vide de niveau DEBUG dans Stackdriver Logging.
Affiche un message de niveau DEBUG dans Stackdriver Logging.
Paramètres
| Nom | Type | Description |
formatOrObject | Object | une chaîne contenant zéro ou plusieurs chaînes de substitution, ou un objet JavaScript à consigner en tant qu'objet JavaScript si aucun autre paramètre n'est défini. |
values | Object... | objets à utiliser pour remplacer les chaînes de substitution dans le message. Vous pouvez ainsi contrôler davantage le format de la sortie. |
time(label)
Démarre un minuteur que vous pouvez utiliser pour suivre la durée d'une opération.
Paramètres
| Nom | Type | Description |
label | String | Nom à attribuer au nouveau minuteur. |
timeEnd(label)
Arrête un minuteur précédemment démarré en appelant console.time(). La durée est enregistrée dans Stackdriver.
Paramètres
| Nom | Type | Description |
label | String | Nom du minuteur à arrêter. |
warn()
Affiche un message vide de niveau AVERTISSEMENT dans Stackdriver Logging.
Affiche un message de niveau AVERTISSEMENT dans Stackdriver Logging.
Paramètres
| Nom | Type | Description |
formatOrObject | Object | une chaîne contenant zéro ou plusieurs chaînes de substitution, ou un objet JavaScript à consigner en tant qu'objet JavaScript si aucun autre paramètre n'est défini. |
values | Object... | objets à utiliser pour remplacer les chaînes de substitution dans le message. Vous pouvez ainsi contrôler davantage le format de la sortie. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
