Class Logger

Logger

Essa classe permite que o desenvolvedor grave texto nos registros de depuração.

Métodos

MétodoTipo de retornoBreve descrição
clear()voidLimpa o registro.
getLog()StringRetorna uma lista completa de mensagens no registro atual.
log(data)LoggerGrava a string no console de geração de registros.
log(format, values)LoggerGrava uma string formatada no console de geração de registros, usando o formato e os valores fornecidos.

Documentação detalhada

clear()

Limpa o registro.


getLog()

Retorna uma lista completa de mensagens no registro atual. Esse método pode ser usado para salvar ou enviar por e-mail toda a saída de registro gerada durante a execução do script.

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

Retorno

String: o registro do console de geração de registros


log(data)

Grava a string no console de geração de registros. Para conferir a saída registrada, selecione Ver > Mostrar registros. Isso pode ser muito útil para depurar scripts.

Parâmetros

NomeTipoDescrição
dataObjecta mensagem para registrar

Retorno

Logger: o logger, para encadeamento.


log(format, values)

Grava uma string formatada no console de geração de registros, usando o formato e os valores fornecidos. A string pode incluir vários marcadores %s, que são substituídos por valores correspondentes da lista de argumentos, convertidos em strings.

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

Parâmetros

NomeTipoDescrição
formatStringuma string de formatação que contém tantas instâncias de %s quanto o número de argumentos values
valuesObject...um número variável de valores a serem inseridos na string de formato

Retorno

Logger: o logger, para encadeamento