Протестируйте надстройку редактора

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

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

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

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

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

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

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

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

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

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

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

При тестировании надстроек редактора таким образом следует помнить о нескольких вещах:

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