Class Logger

أداة التسجيل

تتيح هذه الفئة للمطوّر كتابة نص في سجلات تصحيح الأخطاء.

الطُرق

الطريقةنوع الإرجاعوصف قصير
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.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  Logger.log(files.next().getName());
}
var recipient = Session.getActiveUser().getEmail();
var subject = 'A list of files in your Google Drive';
var body = Logger.getLog();
MailApp.sendEmail(recipient, subject, body);

الإرجاع

String — السجل من وحدة التحكم في التسجيل


log(data)

تكتب السلسلة في وحدة التحكم في التسجيل. للاطّلاع على الناتج الذي تم تسجيله، اختَر عرض >. برنامج تلفزيوني السجلّات يمكن أن يكون ذلك مفيدًا جدًا لتصحيح الأخطاء في النصوص البرمجية.

المعلمات

الاسمالنوعالوصف
dataObjectالرسالة لتسجيل

الإرجاع

Logger — أداة التسجيل، للسلاسل


log(format, values)

تكتب سلسلة منسَّقة إلى وحدة تحكم التسجيل، باستخدام التنسيق والقيم المقدمة. تشير رسالة الأشكال البيانية يمكن أن تتضمن السلسلة عناصر نائبة متعدّدة لـ %s، يتم استبدالها من قائمة الوسيطات، يتم تحويلها إلى سلاسل.

// Log the number of Google Groups you belong to.
var groups = GroupsApp.getGroups();
Logger.log('You are a member of %s Google Groups.', groups.length);

المعلمات

الاسمالنوعالوصف
formatStringسلسلة تنسيق تحتوي على أي عدد من مثيلات %s يساوي عدد values وسيطة
valuesObject...عدد متغير من القيم المطلوب إدراجها في سلسلة التنسيق

الإرجاع

Logger — المسجّل