Class HtmlService

HTML-сервис

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

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

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

Свойство Тип Описание
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 Получает строку пользовательского агента для текущего браузера.

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

create Html Output()

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

const output = HtmlService.createHtmlOutput();

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

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

create Html Output(blob)

Создает новый объект Html Output из ресурса Blob Source .

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

Параметры

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

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

Html Output — новый объект Html Output

Броски

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

create Html Output(html)

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

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

Параметры

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

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

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

Броски

Error — если HTML имеет неправильный формат.

create Html Output From File(filename)

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

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

Параметры

Имя Тип Описание
filename String имя файла, который нужно использовать

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

Html Output — новый объект Html Output

Броски

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

create Template(blob)

Создает новый объект Html Template из ресурса Blob Source .

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

Параметры

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

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

Html Template — новый объект Html Template

Броски

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

create Template(html)

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

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

Параметры

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

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

Html Template — новый объект Html Template

create Template From File(filename)

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

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

Параметры

Имя Тип Описание
filename String имя файла, который нужно использовать

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

Html Template — новый объект Html Template

Броски

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

get User Agent()

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

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

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