Class Logger

Logger

Mit dieser Klasse kann der Entwickler Text in die Fehlerbehebungsprotokolle schreiben.

Methoden

MethodeRückgabetypKurzbeschreibung
clear()voidLöscht das Protokoll.
getLog()StringGibt eine vollständige Liste der Nachrichten im aktuellen Log zurück.
log(data)LoggerSchreibt den String in die Logging-Konsole.
log(format, values)LoggerSchreibt einen formatierten String in die Logging-Konsole. Dabei werden das angegebene Format und die angegebenen Werte verwendet.

Detaillierte Dokumentation

clear()

Löscht das Protokoll.


getLog()

Gibt eine vollständige Liste der Nachrichten im aktuellen Log zurück. Mit dieser Methode kann die gesamte Logausgabe, die während der Skriptausführung generiert wurde, gespeichert oder per E-Mail gesendet werden.

// 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);

Return

String: das Log aus der Logging-Konsole


log(data)

Schreibt den String in die Logging-Konsole. Wählen Sie Ansicht > Logs anzeigen aus, um sich die protokollierte Ausgabe anzeigen zu lassen. Dies kann beim Debugging von Skripts sehr nützlich sein.

Parameter

NameTypBeschreibung
dataObjectdie zu protokollierende Nachricht

Return

Logger: der Logger für Verkettungen.


log(format, values)

Schreibt einen formatierten String in die Logging-Konsole. Dabei werden das angegebene Format und die angegebenen Werte verwendet. Der String kann mehrere %s-Platzhalter enthalten, die durch entsprechende Werte aus der Liste der Argumente ersetzt und in Strings umgewandelt werden.

// 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);

Parameter

NameTypBeschreibung
formatStringEinen Formatstring, der so viele Instanzen von %s enthält wie die Anzahl der values-Argumente
valuesObject...eine variable Anzahl von Werten, die in den Formatstring eingefügt werden sollen

Return

Logger: der Logger für Verkettungen