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