Google Apps Script: Как реализовать конструкцию «если — то — иначе»?

Что такое условные конструкции и зачем они нужны?

Условные конструкции – это фундаментальный инструмент любого языка программирования, включая Google Apps Script. Они позволяют выполнять различные блоки кода в зависимости от того, выполняется определенное условие или нет. Фактически, они предоставляют возможность программе принимать решения, основываясь на данных.

В контексте автоматизации задач с помощью Google Apps Script условные конструкции незаменимы. Например, можно отправлять разные email-уведомления в зависимости от статуса заказа, обновлять данные в Google Sheets только при определенных значениях, или выполнять разные действия в зависимости от дня недели.

Общий синтаксис условных операторов в Apps Script

Google Apps Script, основанный на JavaScript, предоставляет стандартный набор условных операторов: if, if...else, и if...else if...else. Все они используют логические выражения для определения, какой блок кода должен быть выполнен.

Оператор `if` (если)

Базовый синтаксис оператора `if`

Оператор if – самый простой условный оператор. Он выполняет блок кода только в том случае, если условие, указанное в скобках, истинно (true).

if (условие) {
  // Код, который будет выполнен, если условие истинно
}

Примеры использования `if` с простыми условиями

Предположим, у вас есть скрипт для Google Sheets, который должен выделять строки, где значение в столбце "Цена" больше 1000.

function highlightRows() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const priceColumn = 3; // Предположим, столбец "Цена" - третий

  for (let i = 2; i  1000) {
      sheet.getRange(i, 1, 1, sheet.getLastColumn()).setBackground('yellow');
    }
  }
}

В этом примере, код внутри if будет выполнен только для тех строк, где price больше 1000. Остальные строки останутся без изменений.

Работа с числовыми, строковыми и логическими значениями в условиях `if`

Условия в if могут проверять различные типы данных:

Числа: if (x > 10), if (age <= 18), if (price === 0)

Строки: if (name === 'John'), if (email.includes('@example.com')), if (productName != null)

Логические значения: if (isEnabled), if (!isLoggedIn)

Оператор `if…else` (если — то — иначе)

Синтаксис оператора `if…else`

Оператор if...else расширяет возможности if, предоставляя альтернативный блок кода для выполнения, если условие ложно (false).

if (условие) {
  // Код, который будет выполнен, если условие истинно
} else {
  // Код, который будет выполнен, если условие ложно
}

Примеры использования `if…else` для обработки разных сценариев

Рассмотрим пример отправки email-уведомлений в зависимости от статуса платежа.

/**
 * Отправляет уведомление о статусе платежа.
 * @param {string} emailAddress Адрес электронной почты получателя.
 * @param {string} paymentStatus Статус платежа ('success' или 'failed').
 */
function sendPaymentNotification(emailAddress: string, paymentStatus: string) {
  if (paymentStatus === 'success') {
    MailApp.sendEmail({
      to: emailAddress,
      subject: 'Успешный платеж!',
      body: 'Ваш платеж успешно обработан.'
    });
  } else {
    MailApp.sendEmail({
      to: emailAddress,
      subject: 'Ошибка платежа',
      body: 'К сожалению, ваш платеж не был обработан. Пожалуйста, повторите попытку.'
    });
  }
}

Обработка ошибок с помощью `if…else`

if...else также полезен для обработки ошибок. Например, можно проверить, существует ли определенный файл, прежде чем пытаться его открыть.

function openFile(fileName: string) {
  try {
    const file = DriveApp.getFilesByName(fileName).next();
    if (file) {
      //Файл найден, дальнейшие действия
      Logger.log('Файл найден: ' + file.getName());
    } else {
      Logger.log('Файл не найден: ' + fileName);
    }
  } catch (e) {
    Logger.log('Произошла ошибка: ' + e.toString());
  }
}

Оператор `if…else if…else` (если — то — иначе если — иначе)

Синтаксис цепочки `if…else if…else`

Оператор if...else if...else позволяет проверять несколько условий последовательно. Он предоставляет возможность выполнить разные блоки кода в зависимости от того, какое из условий истинно.

if (условие1) {
  // Код, который будет выполнен, если условие1 истинно
} else if (условие2) {
  // Код, который будет выполнен, если условие2 истинно (и условие1 ложно)
} else {
  // Код, который будет выполнен, если все условия ложны
}

Примеры использования для обработки множества условий

Предположим, у вас есть скрипт для автоматической установки ставок в Google Ads в зависимости от показателя качества (Quality Score).

/**
 * Корректирует ставки в Google Ads в зависимости от Quality Score.
 * @param {number} qualityScore Показатель качества ключевого слова.
 * @returns {number} Рекомендуемая корректировка ставки.
 */
function adjustBidByQualityScore(qualityScore: number): number {
  if (qualityScore >= 8) {
    return 0.9; // Уменьшаем ставку на 10% для высокого Quality Score
  } else if (qualityScore >= 5) {
    return 1.0; // Оставляем ставку без изменений для среднего Quality Score
  } else {
    return 1.2; // Увеличиваем ставку на 20% для низкого Quality Score
  }
}

Сравнение `if…else if…else` с другими подходами (например, `switch`)

Для проверки большого количества дискретных значений часто удобнее использовать оператор switch, чем цепочку if...else if...else. Однако if...else if...else более гибок, когда условия основаны на диапазонах или сложных логических выражениях.

Рекомендации по улучшению читаемости сложных условных конструкций

Используйте понятные имена переменных и функций.

Разбивайте сложные условия на более простые, используя логические операторы (&&, ||, !).

Добавляйте комментарии, объясняющие логику условных выражений.

Используйте отступы для четкого выделения блоков кода.

По возможности избегайте глубокой вложенности. Иногда лучше разбить логику на отдельные функции.

Вложенные условные операторы

Что такое вложенные `if` и когда их следует использовать

Вложенные if – это когда один оператор if находится внутри другого. Они используются, когда необходимо проверить несколько условий, причем проверка одного условия зависит от результата другого.

Примеры вложенных `if…else` конструкций

Предположим, вам нужно проверить, авторизован ли пользователь, и, если да, то проверить его роль для определения доступа к определенным функциям.

function checkUserAccess(isLoggedIn: boolean, userRole: string) {
  if (isLoggedIn) {
    if (userRole === 'admin') {
      Logger.log('Доступ разрешен: Полные права администратора.');
    } else if (userRole === 'editor') {
      Logger.log('Доступ разрешен: Права редактора.');
    } else {
      Logger.log('Доступ разрешен: Ограниченные права.');
    }
  } else {
    Logger.log('Доступ запрещен: Пользователь не авторизован.');
  }
}

Как избежать чрезмерной вложенности и улучшить читаемость кода

Чрезмерная вложенность может сделать код сложным для понимания и отладки. Чтобы этого избежать, рассмотрите следующие стратегии:

Используйте логические операторы (&&, ||) для объединения условий. Вместо вложенных if, можно проверить несколько условий в одном операторе.

Выносите части кода в отдельные функции. Это позволит разбить сложную логику на более мелкие и понятные блоки.

Используйте return для преждевременного выхода из функции. Если условие не выполняется, можно сразу выйти из функции, чтобы избежать дальнейшей вложенности.

Рассмотрите возможность использования switch или объектов-карт (ключ-значение) для упрощения логики, где это возможно.

Применяя эти принципы, вы сможете писать более чистый, понятный и поддерживаемый код на Google Apps Script.