Эта страница переведена с помощью 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 — строка пользовательского агента.