سرویس برای برگرداندن 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 | رشته user-agent را برای مرورگر فعلی دریافت می کند. |
مستندات دقیق
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()
رشته user-agent را برای مرورگر فعلی دریافت می کند. اگر در تابع doGet()
یا doPost()
یک برنامه وب استفاده نشود، برای اکثر اجرای اسکریپت ها null
برمی گرداند.
برگشت
String
- رشته عامل کاربر