Сервис для возврата 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 <?= new Date() ?></b>');
Параметры
Имя | Тип | Описание |
---|---|---|
html | String | содержимое шаблона |
Возвращаться
HtmlTemplate
— новый объект HtmlTemplate
createTemplateFromFile(filename)
Создает новый объект HtmlTemplate
из файла в редакторе кода.
var template = HtmlService.createTemplateFromFile('myTemplate');
Параметры
Имя | Тип | Описание |
---|---|---|
filename | String | имя файла, который нужно использовать |
Возвращаться
HtmlTemplate
— новый объект HtmlTemplate
Броски
Error
— если файл не найден
getUserAgent()
Получает строку пользовательского агента для текущего браузера. Возвращает null
для большинства исполнений скриптов, если оно не используется в функции doGet()
или doPost()
веб-приложения.
Возвращаться
String
— строка пользовательского агента.