Class HtmlService

HtmlService

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

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

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

Свойство Тип Описание
Sandbox Mode Sandbox Mode Перечисление, представляющее режимы песочницы, которые можно использовать для клиентских Html Service скриптов.
XFrameOptionsMode XFrameOptionsMode Перечисление, представляющее режимы X-Frame-Options , которые можно использовать для скриптов Html Service на стороне клиента.

Методы

Метод Тип возвращаемого значения Краткое описание
create Html Output() Html Output Создает новый объект Html Output , который может быть возвращен скриптом.
create Html Output(blob) Html Output Создает новый объект Html Output из ресурса Blob Source .
create Html Output(html) Html Output Создает новый объект Html Output , который может быть возвращен скриптом.
create Html Output From File(filename) Html Output Создает новый объект Html Output из файла в редакторе кода.
create Template(blob) Html Template Создает новый объект Html Template на основе ресурса Blob Source .
create Template(html) Html Template Создает новый объект Html Template , который может быть возвращен скриптом.
create Template From File(filename) Html Template Создает новый объект Html Template из файла в редакторе кода.
get User Agent() String Получает строку пользовательского агента для текущего браузера.

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

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

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

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

createHtmlOutput(blob)

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

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

Параметры

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

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

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

Броски

Error — если объект blob не содержит HTML-кода или HTML-код имеет некорректный формат.

createHtmlOutput(html)

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

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

Параметры

Имя Тип Описание
html String контент для показа

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

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

Броски

Error — если HTML-код некорректен.

createHtmlOutputFromFile(filename)

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

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

Параметры

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

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

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

Броски

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

createTemplate(blob)

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

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

Параметры

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

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

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

Броски

Error — если объект не содержит HTML-кода.

createTemplate(html)

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

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

Параметры

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

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

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

createTemplateFromFile(filename)

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

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

Параметры

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

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

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

Броски

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

getUserAgent()

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

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

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