Class TextOutput

خروجی متن

یک شیء TextOutput که می‌تواند از یک اسکریپت ارائه شود.

به دلیل ملاحظات امنیتی، اسکریپت‌ها نمی‌توانند مستقیماً محتوای متنی را به مرورگر برگردانند. در عوض، مرورگر به googleusercontent.com هدایت می‌شود که آن را بدون هیچ گونه پاکسازی یا دستکاری بیشتر نمایش می‌دهد.

شما می‌توانید محتوای متنی را به این صورت برگردانید:

function doGet() {
  return ContentService.createTextOutput('hello world!');
}
همچنین متدهایی برای ارائه JSON، RSS و XML به عنوان TextOutputs وجود دارد؛ متدهای مربوطه را در ContentService مشاهده کنید.

روش‌ها

روش نوع بازگشتی شرح مختصر
append(addedContent) Text Output محتوای جدید را به محتوایی که ارائه خواهد شد، اضافه می‌کند.
clear() Text Output محتوای فعلی را پاک می‌کند.
download As File(filename) Text Output به مرورگرها می‌گوید که به جای نمایش این محتوا، آن را دانلود کنند.
get Content() String محتوایی که ارائه خواهد شد را دریافت می‌کند.
get File Name() String نام فایلی را که قرار است این فایل دانلود شود برمی‌گرداند، یا اگر قرار است نمایش داده شود نه دانلود، مقدار null را برمی‌گرداند.
get Mime Type() Mime Type نوع MIME که این محتوا با آن ارائه خواهد شد را دریافت کنید.
set Content(content) Text Output محتوایی که ارائه خواهد شد را تنظیم می‌کند.
set Mime Type(mimeType) Text Output نوع MIME را برای محتوایی که ارائه خواهد شد تنظیم می‌کند.

مستندات دقیق

append(addedContent)

محتوای جدید را به محتوایی که ارائه خواهد شد، اضافه می‌کند.

پارامترها

نام نوع توضیحات
added Content String محتوایی که باید اضافه شود

بازگشت

TextOutput — خودِ این TextOutput، برای زنجیره‌سازی مفید است.

clear()

محتوای فعلی را پاک می‌کند.

بازگشت

TextOutput — خودِ این TextOutput، برای زنجیره‌سازی مفید است.

downloadAsFile(filename)

به مرورگرها می‌گوید که به جای نمایش این محتوا، آن را دانلود کنند.

بعضی از مرورگرها این تنظیم را نادیده می‌گیرند. تنظیم این مقدار روی null، آن را به رفتار پیش‌فرض نمایش به جای دانلود برمی‌گرداند.

پارامترها

نام نوع توضیحات
filename String نام فایلی که به مرورگر می‌گوید از آن استفاده کند

بازگشت

TextOutput - شیء TextOutput، که برای زنجیره‌سازی مفید است

پرتاب‌ها

Error - اگر نام فایل حاوی کاراکترهای غیرمجاز باشد

getContent()

محتوایی که ارائه خواهد شد را دریافت می‌کند.

بازگشت

String - محتوایی که ارائه خواهد شد

getFileName()

نام فایلی را که قرار است این فایل دانلود شود برمی‌گرداند، یا اگر قرار است نمایش داده شود نه دانلود، مقدار null را برمی‌گرداند.

بازگشت

String - نام فایل

getMimeType()

نوع MIME که این محتوا با آن ارائه خواهد شد را دریافت کنید.

بازگشت

MimeType - نوع mime که با آن ارائه می‌شود

setContent(content)

محتوایی که ارائه خواهد شد را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
content String محتوایی که قرار است ارائه شود

بازگشت

TextOutput — خودِ این TextOutput، برای زنجیره‌سازی مفید است.

setMimeType(mimeType)

نوع MIME را برای محتوایی که ارائه خواهد شد تنظیم می‌کند. مقدار پیش‌فرض متن ساده است.

پارامترها

نام نوع توضیحات
mime Type Mime Type نوع مایم

بازگشت

TextOutput — خودِ این TextOutput، برای زنجیره‌سازی مفید است.