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)

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

פרמטרים

שם	סוג	תיאור
data	Object	ההודעה שצריך לתעד

חזרה

Logger – כלי הרישום לשרשור.

---

log(format, values)

כתיבת מחרוזת מעוצבת במסוף הרישום ביומן, באמצעות הפורמט והערכים שסופקו. המחרוזת יכולה לכלול כמה ערכי placeholder של %s, שיוחלפו ב-placeholders תואמים מרשימת הארגומנטים, שהומרו למחרוזות.

// 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 – יומן הרישום, לשרשור