Class console
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
console
Lớp này cho phép nhà phát triển ghi vào Nhật ký thực thi và Google Cloud Logging nếu tập lệnh được liên kết với một Dự án trên Google Cloud tiêu chuẩn.
Để hỗ trợ đầy đủ tính năng Cloud Logging và ghi nhật ký có cấu trúc, hãy sử dụng Logger. Các phương thức console chuyển đổi tuần tự các đối tượng thành chuỗi và không hỗ trợ jsonPayload trong quá trình ghi nhật ký có cấu trúc 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() {
// ...
}
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
error() | void | Xuất một thông báo cấp ERROR (LỖI) trống vào tính năng Ghi nhật ký Stackdriver. |
error(formatOrObject, values) | void | Xuất thông báo cấp ERROR (LỖI) đến tính năng Ghi nhật ký Stackdriver. |
info() | void | Xuất thông báo cấp INFO trống vào tính năng Ghi nhật ký Stackdriver. |
info(formatOrObject, values) | void | Xuất thông báo cấp INFO sang tính năng Ghi nhật ký Stackdriver. |
log() | void | Xuất một thông báo cấp DEBUG trống vào tính năng Ghi nhật ký Stackdriver. |
log(formatOrObject, values) | void | Xuất thông báo cấp GỠ LỖI sang tính năng Ghi nhật ký Stackdriver. |
time(label) | void | Bắt đầu một bộ hẹn giờ mà bạn có thể sử dụng để theo dõi thời gian thực hiện một thao tác. |
timeEnd(label) | void | Dừng một bộ hẹn giờ đã bắt đầu trước đó bằng cách gọi console.time(). |
warn() | void | Xuất một thông báo cấp WARNING (CẢNH BÁO) trống vào tính năng Ghi nhật ký Stackdriver. |
warn(formatOrObject, values) | void | Xuất một thông báo cấp WARNING (CẢNH BÁO) đến tính năng Ghi nhật ký Stackdriver. |
Tài liệu chi tiết
error()
Xuất một thông báo cấp ERROR (LỖI) trống vào tính năng Ghi nhật ký Stackdriver.
Xuất thông báo cấp ERROR (LỖI) đến tính năng Ghi nhật ký Stackdriver.
Tham số
| Tên | Loại | Mô tả |
formatOrObject | Object | một chuỗi chứa không có hoặc nhiều chuỗi thay thế, hoặc một đối tượng JavaScript sẽ được ghi lại dưới dạng đối tượng JavaScript nếu không có tham số nào khác. |
values | Object... | đối tượng để thay thế chuỗi thay thế trong thông báo. Điều này giúp bạn kiểm soát thêm định dạng của kết quả. |
info()
Xuất thông báo cấp INFO trống vào tính năng Ghi nhật ký Stackdriver.
Xuất thông báo cấp INFO sang tính năng Ghi nhật ký Stackdriver.
Tham số
| Tên | Loại | Mô tả |
formatOrObject | Object | một chuỗi chứa không có hoặc nhiều chuỗi thay thế, hoặc một đối tượng JavaScript sẽ được ghi lại dưới dạng đối tượng JavaScript nếu không có tham số nào khác. |
values | Object... | đối tượng để thay thế chuỗi thay thế trong thông báo. Điều này giúp bạn kiểm soát thêm định dạng của kết quả. |
log()
Xuất một thông báo cấp DEBUG trống vào tính năng Ghi nhật ký Stackdriver.
Xuất thông báo cấp GỠ LỖI sang tính năng Ghi nhật ký Stackdriver.
Tham số
| Tên | Loại | Mô tả |
formatOrObject | Object | một chuỗi chứa không có hoặc nhiều chuỗi thay thế, hoặc một đối tượng JavaScript sẽ được ghi lại dưới dạng đối tượng JavaScript nếu không có tham số nào khác. |
values | Object... | đối tượng để thay thế chuỗi thay thế trong thông báo. Điều này giúp bạn kiểm soát thêm định dạng của kết quả. |
time(label)
Bắt đầu một bộ hẹn giờ mà bạn có thể sử dụng để theo dõi thời gian thực hiện một thao tác.
Tham số
| Tên | Loại | Mô tả |
label | String | Tên để đặt cho bộ hẹn giờ mới. |
timeEnd(label)
Dừng một bộ hẹn giờ đã bắt đầu trước đó bằng cách gọi console.time(). Thời lượng sẽ được ghi lại trong Stackdriver.
Tham số
| Tên | Loại | Mô tả |
label | String | tên của đồng hồ hẹn giờ cần dừng. |
warn()
Xuất một thông báo cấp WARNING (CẢNH BÁO) trống vào tính năng Ghi nhật ký Stackdriver.
Xuất một thông báo cấp WARNING (CẢNH BÁO) đến tính năng Ghi nhật ký Stackdriver.
Tham số
| Tên | Loại | Mô tả |
formatOrObject | Object | một chuỗi chứa không có hoặc nhiều chuỗi thay thế, hoặc một đối tượng JavaScript sẽ được ghi lại dưới dạng đối tượng JavaScript nếu không có tham số nào khác. |
values | Object... | đối tượng để thay thế chuỗi thay thế trong thông báo. Điều này giúp bạn kiểm soát thêm định dạng của kết quả. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]
