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

Class 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 — строка пользовательского агента