Class HtmlService

HtmlService

用於從指令碼傳回 HTML 和其他文字內容的服務。

基於安全考量，指令碼無法將內容直接傳回瀏覽器。而是必須清理 HTML，讓它無法執行惡意操作。如要瞭解此情況隱含哪些限制，請參閱 HtmlOutput 的說明。

屬性

屬性	類型	說明
SandboxMode	SandboxMode	列舉代表可用於用戶端 HtmlService 指令碼的沙箱模式。
XFrameOptionsMode	XFrameOptionsMode	列舉代表可用於用戶端 HtmlService 指令碼的 X-Frame-Options 模式。

方法

方法	傳回類型	簡短說明
createHtmlOutput()	HtmlOutput	建立可從指令碼傳回的新 HtmlOutput 物件。
createHtmlOutput(blob)	HtmlOutput	從 BlobSource 資源建立新的 HtmlOutput 物件。
createHtmlOutput(html)	HtmlOutput	建立可從指令碼傳回的新 HtmlOutput 物件。
createHtmlOutputFromFile(filename)	HtmlOutput	在程式碼編輯器中，根據檔案建立新的 HtmlOutput 物件。
createTemplate(blob)	HtmlTemplate	從 BlobSource 資源建立新的 HtmlTemplate 物件。
createTemplate(html)	HtmlTemplate	建立可從指令碼傳回的新 HtmlTemplate 物件。
createTemplateFromFile(filename)	HtmlTemplate	在程式碼編輯器中，根據檔案建立新的 HtmlTemplate 物件。
getUserAgent()	String	取得目前瀏覽器的使用者代理程式字串。

內容詳盡的說明文件

createHtmlOutput()

建立可從指令碼傳回的新 HtmlOutput 物件。

var output = HtmlService.createHtmlOutput();

回攻員

HtmlOutput：新的 HtmlOutput 物件

---

createHtmlOutput(blob)

從 BlobSource 資源建立新的 HtmlOutput 物件。

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

參數

名稱	類型	說明
blob	BlobSource	要取得 HTML 的

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果 blob 不含 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)

從 BlobSource 資源建立新的 HtmlTemplate 物件。

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

參數

名稱	類型	說明
blob	BlobSource	要取得 HTML 中的物件。

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

擲回

Error — 如果 blob 不含 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()

取得目前瀏覽器的使用者代理程式字串。如果未在網頁應用程式的 doGet() 或 doPost() 函式中使用，則針對大多數指令碼執行會傳回 null。

回攻員

String：使用者代理程式字串