Class HtmlService

HtmlService

Сервис для возврата HTML и другого текстового контента из скрипта.

Из соображений безопасности сценарии не могут напрямую возвращать содержимое в браузер. Вместо этого они должны дезинфицировать HTML, чтобы он не мог выполнять вредоносные действия. См. описание HtmlOutput чтобы узнать, какие ограничения это накладывает на то, что может быть возвращено.

Характеристики

Имущество Тип Описание
SandboxMode SandboxMode Перечисление, представляющее режимы песочницы, которые можно использовать для клиентских сценариев HtmlService .
XFrameOptionsMode XFrameOptionsMode Перечисление, представляющее режимы X-Frame-Options , которые можно использовать для сценариев HtmlService на стороне клиента.

Методы

Метод Тип возврата Краткое описание
createHtmlOutput() HtmlOutput Создает новый объект HtmlOutput , который может быть возвращен из сценария.
createHtmlOutput(blob) HtmlOutput Создает новый объект HtmlOutput из ресурса BlobSource .
createHtmlOutput(html) HtmlOutput Создает новый объект HtmlOutput , который может быть возвращен из сценария.
createHtmlOutputFromFile(filename) HtmlOutput Создает новый объект HtmlOutput из файла в редакторе кода.
createTemplate(blob) HtmlTemplate Создает новый объект HtmlTemplate из ресурса BlobSource .
createTemplate(html) HtmlTemplate Создает новый объект HtmlTemplate , который может быть возвращен из сценария.
createTemplateFromFile(filename) HtmlTemplate Создает новый объект HtmlTemplate из файла в редакторе кода.
getUserAgent() String Получает строку пользовательского агента для текущего браузера.

Подробная документация

createHtmlOutput()

Создает новый объект HtmlOutput , который может быть возвращен из сценария.

var output = HtmlService.createHtmlOutput();

Возвращаться

HtmlOutput — новый объект HtmlOutput.


createHtmlOutput(blob)

Создает новый объект HtmlOutput из ресурса BlobSource .

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

Параметры

Имя Тип Описание
blob BlobSource объект, из которого нужно получить HTML

Возвращаться

HtmlOutput — новый объект HtmlOutput

Броски

Error — если большой двоичный объект не содержит HTML или HTML имеет неверный формат.


createHtmlOutput(html)

Создает новый объект HtmlOutput , который может быть возвращен из сценария.

var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

Параметры

Имя Тип Описание
html String контент для обслуживания

Возвращаться

HtmlOutput — новый объект HtmlOutput.

Броски

Error — если html неверный формат


createHtmlOutputFromFile(filename)

Создает новый объект HtmlOutput из файла в редакторе кода.

var output = HtmlService.createHtmlOutputFromFile('myPage');

Параметры

Имя Тип Описание
filename String имя файла для использования

Возвращаться

HtmlOutput — новый объект HtmlOutput

Броски

Error — если файл не найден или HTML-код в нем неверный.


createTemplate(blob)

Создает новый объект HtmlTemplate из ресурса BlobSource .

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

Параметры

Имя Тип Описание
blob BlobSource Объект, из которого нужно получить HTML.

Возвращаться

HtmlTemplate — новый объект HtmlTemplate

Броски

Error — если блоб не содержит HTML


createTemplate(html)

Создает новый объект HtmlTemplate , который может быть возвращен из сценария.

var template = HtmlService.createTemplate('<b>The time is &lt;?= new Date() ?&gt;</b>');

Параметры

Имя Тип Описание
html String содержание шаблона

Возвращаться

HtmlTemplate — новый объект HtmlTemplate


createTemplateFromFile(filename)

Создает новый объект HtmlTemplate из файла в редакторе кода.

var template = HtmlService.createTemplateFromFile('myTemplate');

Параметры

Имя Тип Описание
filename String имя файла для использования

Возвращаться

HtmlTemplate — новый объект HtmlTemplate

Броски

Error — если файл не найден


getUserAgent()

Получает строку пользовательского агента для текущего браузера. Возвращает null для большинства выполнений скриптов, если они не используются в функциях doGet() или doPost() веб-приложения.

Возвращаться

String — строка пользовательского агента