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 - 来自 Logging 控制台的日志


log(data)

将字符串写入日志记录控制台。如需查看记录的输出,请选择查看 &gt 显示日志。这对于调试脚本非常有用。

参数

名称类型说明
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 - Logger,用于串联