Class console
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
کنسول اگر اسکریپت با پروژه استاندارد Cloud مرتبط است، این کلاس به توسعهدهنده اجازه میدهد تا در گزارش اجرا و Google Cloud Logging بنویسد.
برای پشتیبانی کامل از Cloud Logging و گزارش ساختار یافته، از Logger
استفاده کنید. متدهای console
اشیاء را به رشتهها سریال میکنند و json Payload
به عنوان بخشی از Log Entry
ساختار یافته پشتیبانی نمیکنند.
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() {
// ...
}
روش ها
روش | نوع برگشت | شرح مختصر |
---|
error() | void | یک پیام سطح ERROR خالی را به Stackdriver Logging ارسال می کند. |
error(formatOrObject, values) | void | یک پیام سطح ERROR را به Stackdriver Logging ارسال می کند. |
info() | void | پیام سطح INFO خالی را به Stackdriver Logging ارسال می کند. |
info(formatOrObject, values) | void | یک پیام سطح اطلاعات را به Stackdriver Logging ارسال می کند. |
log() | void | خروجی یک پیام سطح DEBUG خالی به Stackdriver Logging. |
log(formatOrObject, values) | void | یک پیام سطح DEBUG را به Stackdriver Logging ارسال می کند. |
time(label) | void | یک تایمر را شروع می کند که می توانید از آن برای پیگیری مدت زمان انجام یک عملیات استفاده کنید. |
time End(label) | void | تایمری را که قبلاً با فراخوانی console.time() شروع شده بود متوقف می کند. |
warn() | void | یک پیام سطح هشدار خالی را به Stackdriver Logging ارسال می کند. |
warn(formatOrObject, values) | void | یک پیام سطح هشدار را به Stackdriver Logging ارسال می کند. |
مستندات دقیق
error()
یک پیام سطح ERROR خالی را به Stackdriver Logging ارسال می کند.
یک پیام سطح ERROR را به Stackdriver Logging ارسال می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
format Or Object | Object | یک رشته حاوی صفر یا چند رشته جایگزین یا یک شی جاوا اسکریپت که در صورت عدم وجود پارامترهای دیگر به عنوان یک شی جاوا اسکریپت ثبت می شود. |
values | Object... | اشیایی که می توان رشته های جایگزین را در پیام جایگزین کرد. این به شما کنترل بیشتری بر روی فرمت خروجی می دهد. |
info()
پیام سطح INFO خالی را به Stackdriver Logging ارسال می کند.
یک پیام سطح اطلاعات را به Stackdriver Logging ارسال می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
format Or Object | Object | یک رشته حاوی صفر یا چند رشته جایگزین یا یک شی جاوا اسکریپت که در صورت عدم وجود پارامترهای دیگر به عنوان یک شی جاوا اسکریپت ثبت می شود. |
values | Object... | اشیایی که می توان رشته های جایگزین را در پیام جایگزین کرد. این به شما کنترل بیشتری بر روی فرمت خروجی می دهد. |
log()
خروجی یک پیام سطح DEBUG خالی به Stackdriver Logging.
یک پیام سطح DEBUG را به Stackdriver Logging ارسال می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
format Or Object | Object | یک رشته حاوی صفر یا چند رشته جایگزین یا یک شی جاوا اسکریپت که در صورت عدم وجود پارامترهای دیگر به عنوان یک شی جاوا اسکریپت ثبت می شود. |
values | Object... | اشیایی که می توان رشته های جایگزین را در پیام جایگزین کرد. این به شما کنترل بیشتری بر روی فرمت خروجی می دهد. |
time(label)
یک تایمر را شروع می کند که می توانید از آن برای پیگیری مدت زمان انجام یک عملیات استفاده کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|
label | String | نامی که باید به تایمر جدید بدهید. |
time End(label)
تایمری را که قبلاً با فراخوانی console.time()
شروع شده بود متوقف می کند. مدت زمان در Stackdriver ثبت شده است.
پارامترها
نام | تایپ کنید | توضیحات |
---|
label | String | نام تایمر برای توقف |
warn()
یک پیام سطح هشدار خالی را به Stackdriver Logging ارسال می کند.
یک پیام سطح هشدار را به Stackdriver Logging ارسال می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
format Or Object | Object | یک رشته حاوی صفر یا چند رشته جایگزین یا یک شی جاوا اسکریپت که در صورت عدم وجود پارامترهای دیگر به عنوان یک شی جاوا اسکریپت ثبت می شود. |
values | Object... | اشیایی که می توان رشته های جایگزین را در پیام جایگزین کرد. این به شما کنترل بیشتری بر روی فرمت خروجی می دهد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]