Тестирование дополнения к редактору

Дополнения следует тщательно протестировать перед публикацией, чтобы убедиться, что они ведут себя так, как задумано. Apps Script позволяет тестировать разрабатываемые надстройки редактора на конкретных файлах Google Docs Sheets, Forms или Slides. Это можно использовать для:

  • Убедитесь, что надстройка, написанная в автономном скрипте, работает должным образом при применении к листу, документу, презентации или форме.
  • Убедитесь, что процесс установки надстройки работает должным образом, особенно для различных начальных состояний жизненного цикла авторизации ( установлено, включено или и то, и другое ).
  • Убедитесь, что надстройка работает должным образом при работе с конкретным документом и его содержимым.
  • Тестируйте и сравнивайте текущую и предыдущую версии дополнения.

Создайте тестовое развертывание

Тестовое развертывание — это комбинация надстройки и тестового документа. Если у вас есть разработанная версия сценария и вы хотите протестировать ее в качестве дополнения, выполните следующие действия:

  1. Если у вас его еще нет, создайте электронную таблицу, документ, презентацию или форму, чтобы протестировать надстройку.
  2. Откройте проект сценария, содержащий ваше дополнение.
  3. Щелкните Развертывание > Тестовые развертывания .
  4. Рядом с пунктом «Выбрать тип» нажмите «Включить типов развертывания» и выберите «Дополнение редактора» .
  5. Нажмите Создать новый тест или Добавить тест .
  6. Выберите версию кода или выберите «Последний код» .
  7. В разделе Конфигурация выберите начальное состояние авторизации для теста.
  8. В разделе «Тестовый документ» нажмите «Документ не выбран» . Выберите файл Таблиц, Документов, Слайдов или Форм, который вы хотите использовать для тестирования надстройки, и нажмите Вставить .
  9. Нажмите Сохранить тест .

Все сохраненные тестовые развертывания отображаются в диалоговом окне «Тестовые развертывания» . Это позволит вам вернуться к тому же тестовому развертыванию позже.

Запустите тестовое развертывание

Если у вас есть одно или несколько сохраненных тестовых развертываний, вы можете запустить одно из них, выполнив следующие действия:

  1. Откройте проект сценария, содержащий ваше дополнение.
  2. Щелкните Развертывание > Тестовые развертывания .
  3. В разделе «Сохраненные тесты» выберите переключатель рядом с сохраненным развертыванием теста, который вы хотите запустить, и нажмите «Выполнить» .

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

Детали тестирования

При таком тестировании надстроек редактора следует учитывать ряд вещей:

  • Устанавливаемые триггеры не поддерживаются при тестировании. Функциональность, зависящая от устанавливаемых триггеров, не подлежит тестированию.
  • При запуске тестового развертывания, настроенного на тестирование с использованием последней версии кода, вы можете увидеть изменения, сохраненные в сценарии надстройки, обновив тестовый документ.
  • У тестового документа есть URL-адрес, которым вы можете поделиться с редакторами исходного тестового документа. Таким образом, вам будет легче сотрудничать с другими при тестировании и разработке.
  • Если ваша надстройка использует службу свойств , свойства сохраняются и остаются доступными при следующем запуске тестового развертывания.
  • Кроме того, любое тестовое развертывание, в котором используется одна и та же комбинация надстройки и тестового документа, имеет доступ к одной и той же информации о свойствах. Например, если вы создаете два тестовых развертывания, свойства, сохраненные при запуске первого, будут доступны при запуске второго и наоборот, но только если в развертываниях используется один и тот же сценарий и тестовый документ.
  • Если вы запускаете тестовое развертывание, вам может быть предложено авторизоваться, если вы еще не запускали сценарий. Имейте в виду, что авторизация сценария во время тестирования также авторизует сценарий вне тестирования.