Class Logger

المسجِّل

تسمح هذه الفئة للمطوّر بالكتابة في سجلّ التنفيذ وسجلّات Google Cloud إذا كان النص البرمجي مرتبطًا بمشروع عادي على Cloud. يُفضّل استخدام هذه الفئة للتسجيل المنظَّم وjsonPayload دعم في Cloud Logging. لتسجيل البيانات بالاستناد إلى الوقت، استخدِم console.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
clear()	void	يمحو السجلّ.
getLog()	String	تعرِض هذه الدالة قائمة كاملة بالرسائل في السجلّ الحالي.
log(data)	Logger	كتابة البيانات في السجلّ
log(format, values)	Logger	يُستخدَم لكتابة سلسلة منسَّقة في وحدة تحكّم التسجيل، باستخدام التنسيق والقيم المقدَّمة.

مستندات تفصيلية

clear()

يمحو السجلّ.

---

getLog()

تعرِض هذه الدالة قائمة كاملة بالرسائل في السجلّ الحالي. يمكن استخدام هذه الطريقة لحفظ ناتج السجلّ بالكامل الذي تم إنشاؤه أثناء تنفيذ النص البرمجي أو إرساله بالبريد الإلكتروني.

// 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، يتم استخدام هذه السمة كرسالة السجلّ. بخلاف ذلك، يتم استدعاء الطريقة toString() لتحويل العنصر إلى سلسلة. يتم تضمين كل السمات الأخرى التي يمكن تسلسلها باستخدام JSON كجزء من jsonPayload في LogEntry، على غرار المثال أدناه:

{
  "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 — المسجّل، لتسلسل الطلبات