Class Logger

Logger

Ta klasa umożliwia deweloperowi zapisywanie danych w dzienniku wykonania i w Google Cloud Logging, jeśli skrypt jest powiązany z standardowym projektem Cloud. Ta klasa jest preferowana w przypadku logowania uporządkowanego i obsługi jsonPayload w Cloud Logging. W przypadku rejestrowania na podstawie czasu użyj console.

Metody

MetodaZwracany typKrótki opis
clear()voidCzyści dziennik.
getLog()StringZwraca pełną listę wiadomości w bieżącym dzienniku.
log(data)LoggerZapisuje dane w dzienniku.
log(format, values)LoggerZapisuje sformatowany ciąg znaków w konsoli rejestrowania, używając podanego formatu i wartości.

Szczegółowa dokumentacja

clear()

Czyści dziennik.

getLog()

Zwraca pełną listę wiadomości w bieżącym dzienniku. Za pomocą tej metody możesz zapisać lub wysłać e-mailem cały dziennik utworzony podczas wykonywania skryptu. 

// Generate a log, then email it to the person who ran the script. const files = DriveApp.getFiles(); while (files.hasNext()) {   Logger.log(files.next().getName()); } const recipient = Session.getActiveUser().getEmail(); const subject = 'A list of files in your Google Drive'; const body = Logger.getLog(); MailApp.sendEmail(recipient, subject, body);

Powrót

String – dziennik z konsoli rejestrowania

log(data)

Zapisuje dane w dzienniku. Dane mogą być ciągiem znaków, obiektem JavaScriptu lub obiektem z właściwością message. 

Logger.log("my log message"); // Info   my logmessage Logger.log({ key: "value" }); // Info   {key=value} Logger.log({ message: "my log message", data: { key: "value" } }) // Info   my logmessage

Jeśli podczas przekazywania obiektu zawiera on właściwość message, jest ona używana jako wiadomość dziennika. W przeciwnym razie wywoływana jest metoda toString(), która służy do konwertowania obiektu na ciąg znaków. Wszystkie inne właściwości, które można zserializować w formacie JSON, są uwzględniane w jsonPayload w LogEntry, podobnie jak w przykładzie poniżej: 

{   "insertId": "w5eib...",   "jsonPayload": {     "message": "my log message",     "serviceContext": {       "service": "AKfyc..."     },     "data": {       "key": "value"     }   },   "resource": {     "type": "app_script_function",     "labels": {       "invocation_type": "editor",       "function_name": "unknown",       "project_id": "1234567890"     }   },   "timestamp": "2024-11-15T23:28:19.448591Z",   "severity": "INFO",   "labels": {     "script.googleapis.com/user_key": "AOX2d...",     "script.googleapis.com/process_id": "EAEA1...",     "script.googleapis.com/project_key": "MQXvl...",     "script.googleapis.com/deployment_id": "AKfyc..."   },   "logName": "projects/[PROJECT_ID]/logs/script.googleapis.com%2Fconsole_logs",   "receiveTimestamp": "2024-11-15T23:28:20.363790313Z" }

Parametry

NazwaTypOpis
dataObjectobiekt do zarejestrowania.

Powrót

Logger – Logger, do łańcuchowania.

log(format, values)

Zapisuje sformatowany ciąg znaków w konsoli rejestrowania, używając podanego formatu i wartości. Ciąg tekstowy może zawierać wiele obiektów zastępczych %s, które są zastępowane przez odpowiadające im wartości z listy argumentów, przekształcone w ciągi tekstowe. 

// Log the number of Google Groups you belong to. const groups = GroupsApp.getGroups(); Logger.log('You are a member of %s Google Groups.', groups.length);

Parametry

NazwaTypOpis
formatStringciąg znaków formatu zawierający tyle wystąpień argumentu %s, ile jest argumentów values;
valuesObject...zmienną liczbę wartości do wstawienia w ciągu formatowania;

Powrót

Logger – Logger, do łańcuchowania