Class Logger

يمحو السجلّ.

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

// 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: السجلّ من وحدة تحكّم التسجيل

كتابة البيانات في السجلّ يمكن أن تكون البيانات سلسلة أو عنصر 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"
}

المعلمات

الإرجاع

Logger: المسجّل، لإنشاء سلاسل.

يُستخدَم لكتابة سلسلة منسَّقة في وحدة تحكّم التسجيل، باستخدام التنسيق والقيم المقدَّمة. يمكن أن تتضمّن السلسلة عناصر نائبة متعددة من النوع %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);

المعلمات

الإرجاع

Logger — المسجّل، لتسلسل الطلبات