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)

כותבת את המחרוזת במסוף הרישום ביומן. כדי להציג את הפלט שנרשם ביומן, בוחרים באפשרות View > Showlogs (תצוגה > הצגת יומנים). האפשרות הזו יכולה להיות שימושית מאוד לניפוי באגים בסקריפטים.

פרמטרים

שם	תיאור	התיאור
data	Object	ההודעה לרישום

החזרות

Logger - הרישום ביומן, לשרשורים.

---

log(format, values)

כותבת מחרוזת מעוצבת למסוף הרישום ביומן, בפורמט ובערכים שסופקו. המחרוזת יכולה לכלול כמה placeholders של %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);

פרמטרים

שם	תיאור	התיאור
format	String	מחרוזת פורמט שמכילה כמה מופעים של %s כמספר values ארגומנטים
values	Object...	מספר משתנה של ערכים שיש להוסיף למחרוזת הפורמט

החזרות

Logger – רישום ביומן, לשרשרת