Эта страница переведена с помощью Cloud Translation API.

Class HtmlService

Сервис для возврата 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 — строка пользовательского агента.