تسمح هذه الفئة للمطوّر بالكتابة في سجلّ التنفيذ وسجلّات Google Cloud إذا كان النص البرمجي مرتبطًا
بمشروع عادي
على Cloud. يُفضّل استخدام هذه الفئة للتسجيل المنظَّم وjson
دعم
في Cloud Logging. لتسجيل البيانات بالاستناد إلى الوقت، استخدِم console
.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
clear() | void | يمحو السجلّ. |
get | String | تعرِض هذه الدالة قائمة كاملة بالرسائل في السجلّ الحالي. |
log(data) | Logger | كتابة البيانات في السجلّ |
log(format, values) | Logger | يُستخدَم لكتابة سلسلة منسَّقة في وحدة تحكّم التسجيل، باستخدام التنسيق والقيم المقدَّمة. |
مستندات تفصيلية
clear()
يمحو السجلّ.
get Log()
تعرِض هذه الدالة قائمة كاملة بالرسائل في السجلّ الحالي. يمكن استخدام هذه الطريقة لحفظ ناتج السجلّ بالكامل الذي تم إنشاؤه أثناء تنفيذ النص البرمجي أو إرساله بالبريد الإلكتروني.
// Generate a log, then email it to the person who ran the script. const files = DriveApp.getFiles(); while (files.hasNext()) { Logger.log(files.next().getName()); } const recipient = Session.getActiveUser().getEmail(); const subject = 'A list of files in your Google Drive'; const body = Logger.getLog(); MailApp.sendEmail(recipient, subject, body);
الإرجاع
String
: السجلّ من وحدة تحكّم التسجيل
log(data)
كتابة البيانات في السجلّ يمكن أن تكون البيانات سلسلة أو عنصر JavaScript أو عنصرًا يتضمّن سمة
message
.
Logger.log("my log message"); // Info my logmessage Logger.log({ key: "value" }); // Info {key=value} Logger.log({ message: "my log message", data: { key: "value" } }) // Info my logmessage
عند تمرير عنصر، إذا كان العنصر يحتوي على سمة message
، يتم
استخدام هذه السمة كرسالة السجلّ. بخلاف ذلك، يتم استدعاء الطريقة to
لتحويل
العنصر إلى سلسلة. يتم تضمين كل السمات الأخرى التي يمكن تسلسلها باستخدام JSON كجزء من
json
في Log
، على غرار المثال أدناه:
{ "insertId": "w5eib...", "jsonPayload": { "message": "my log message", "serviceContext": { "service": "AKfyc..." }, "data": { "key": "value" } }, "resource": { "type": "app_script_function", "labels": { "invocation_type": "editor", "function_name": "unknown", "project_id": "1234567890" } }, "timestamp": "2024-11-15T23:28:19.448591Z", "severity": "INFO", "labels": { "script.googleapis.com/user_key": "AOX2d...", "script.googleapis.com/process_id": "EAEA1...", "script.googleapis.com/project_key": "MQXvl...", "script.googleapis.com/deployment_id": "AKfyc..." }, "logName": "projects/[PROJECT_ID]/logs/script.googleapis.com%2Fconsole_logs", "receiveTimestamp": "2024-11-15T23:28:20.363790313Z" }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
data | Object | العنصر المطلوب تسجيله |
الإرجاع
Logger
: المسجّل، لإنشاء سلاسل.
log(format, values)
يُستخدَم لكتابة سلسلة منسَّقة في وحدة تحكّم التسجيل، باستخدام التنسيق والقيم المقدَّمة. يمكن أن تتضمّن السلسلة
عناصر نائبة متعددة من النوع %s
، ويتم استبدالها بالقيم
المقابلة لها من قائمة الوسيطات التي تم تحويلها إلى سلاسل.
// Log the number of Google Groups you belong to. const groups = GroupsApp.getGroups(); Logger.log('You are a member of %s Google Groups.', groups.length);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
format | String | سلسلة تنسيق تحتوي على عدد مرات ظهور %s يساوي عدد values |
values | Object... | عدد متغيّر من القيم لإدراجها في سلسلة التنسيق |
الإرجاع
Logger
— المسجّل، لتسلسل الطلبات