Class TextOutput
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
خروجی متن یک شی TextOutput که می تواند از یک اسکریپت ارائه شود.
به دلیل ملاحظات امنیتی، اسکریپت ها نمی توانند مستقیماً محتوای متنی را به مرورگر برگردانند. در عوض، مرورگر به googleusercontent.com هدایت می‌شود، که آن را بدون هیچ گونه پاکسازی یا دستکاری بیشتر نمایش می‌دهد.
می توانید محتوای متنی را به این صورت برگردانید:
function doGet() {
return ContentService.createTextOutput('hello world!');
}همچنین روش هایی برای ارائه JSON، RSS و XML به عنوان TextOutput وجود دارد. روش های مربوطه را در
Content Service ببینید.
مستندات دقیق
append(addedContent)
محتوای جدیدی را به محتوایی که ارائه می شود اضافه می کند.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
added Content | String | محتوا برای پیوست |
بازگشت
Text Output - خود این TextOutput برای زنجیره‌بندی مفید است
clear()
محتوای فعلی را پاک می کند.
بازگشت
Text Output - خود این TextOutput برای زنجیره‌بندی مفید است
download As File(filename)
به مرورگرها می گوید به جای نمایش این محتوا، دانلود کنند.
برخی از مرورگرها این تنظیم را نادیده می گیرند. با تنظیم آن بر روی null، آن را به رفتار پیش فرض نمایش به جای دانلود پاک می کند.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
filename | String | نام فایلی که به مرورگر بگویید استفاده کند |
بازگشت
Text Output - شی TextOutput، مفید برای زنجیره‌بندی
پرتاب می کند
Error - اگر نام فایل حاوی کاراکترهای غیرقانونی باشد
get Content()
محتوایی را دریافت می کند که ارائه می شود.
بازگشت
String - محتوایی که ارائه خواهد شد
get File Name()
نام فایل را برای بارگیری این فایل به‌عنوان به‌عنوان بارگیری برمی‌گرداند، یا اگر باید به جای دانلود، نمایش داده شود، null است.
بازگشت
String - نام فایل
get Mime Type()
نوع Mime این محتوا را دریافت کنید.
بازگشت
Mime Type - نوع Mime که با آن سرو می شود
set Content(content)
محتوای ارائه شده را تنظیم می کند.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
content | String | محتوای مورد نظر برای ارائه |
بازگشت
Text Output - خود این TextOutput برای زنجیره‌بندی مفید است
set Mime Type(mimeType)
نوع mime را برای محتوایی که ارائه می شود تنظیم می کند. پیش فرض متن ساده است.
پارامترها
| نام | تایپ کنید | توضیحات |
|---|
mime Type | Mime Type | نوع میم |
بازگشت
Text Output - خود این TextOutput برای زنجیره‌بندی مفید است
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eA \u003ccode\u003eTextOutput\u003c/code\u003e object enables scripts to serve text content securely by redirecting the browser to \u003ccode\u003egoogleusercontent.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods to serve various content types such as JSON, RSS, and XML using the \u003ccode\u003eContentService\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manipulate the output using methods like \u003ccode\u003eappend\u003c/code\u003e, \u003ccode\u003eclear\u003c/code\u003e, \u003ccode\u003edownloadAsFile\u003c/code\u003e, \u003ccode\u003egetContent\u003c/code\u003e, \u003ccode\u003egetFileName\u003c/code\u003e, \u003ccode\u003egetMimeType\u003c/code\u003e, \u003ccode\u003esetContent\u003c/code\u003e, and \u003ccode\u003esetMimeType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTextOutput\u003c/code\u003e enhances security by preventing direct return of text content to the browser from scripts.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edownloadAsFile\u003c/code\u003e method enables content to be downloaded instead of displayed, offering flexibility in how the output is handled.\u003c/p\u003e\n"]]],["TextOutput objects allow scripts to serve text content, which browsers access via redirection to googleusercontent.com. Key actions include: `append()` to add content, `clear()` to erase content, `downloadAsFile()` to trigger downloads, `getContent()` to retrieve content, `getFileName()` and `getMimeType()` to get metadata. `setContent()` sets the content, and `setMimeType()` specifies the content type. Scripts can use it to create outputs in text, JSON, RSS, and XML formats.\n"],null,["# Class TextOutput\n\nTextOutput\n\nA TextOutput object that can be served from a script.\n\nDue to security considerations, scripts cannot directly return text content to a browser.\nInstead, the browser is redirected to googleusercontent.com, which will display it without any\nfurther sanitization or manipulation.\n\nYou can return text content like this:\n\n```javascript\nfunction doGet() {\n return ContentService.createTextOutput('hello world!');\n}\n```\nThere are also methods to serve JSON, RSS, and XML as TextOutputs; see the corresponding methods on [ContentService](/apps-script/reference/content/content-service). \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|\n| [append(addedContent)](#append(String)) | [TextOutput](#) | Appends new content to the content that will be served. |\n| [clear()](#clear()) | [TextOutput](#) | Clears the current content. |\n| [downloadAsFile(filename)](#downloadAsFile(String)) | [TextOutput](#) | Tells browsers to download rather than display this content. |\n| [getContent()](#getContent()) | `String` | Gets the content that will be served. |\n| [getFileName()](#getFileName()) | `String` | Returns the file name to download this file as, or null if it should be displayed rather than downloaded. |\n| [getMimeType()](#getMimeType()) | [MimeType](/apps-script/reference/content/mime-type) | Get the mime type this content will be served with. |\n| [setContent(content)](#setContent(String)) | [TextOutput](#) | Sets the content that will be served. |\n| [setMimeType(mimeType)](#setMimeType(MimeType)) | [TextOutput](#) | Sets the mime type for content that will be served. |\n\nDetailed documentation\n----------------------\n\n### `append(addedContent)`\n\nAppends new content to the content that will be served.\n\n#### Parameters\n\n| Name | Type | Description |\n|------------------|----------|-----------------------|\n| `added``Content` | `String` | the content to append |\n\n#### Return\n\n\n[TextOutput](#) --- this TextOutput itself, useful for chaining\n\n*** ** * ** ***\n\n### `clear()`\n\nClears the current content.\n\n#### Return\n\n\n[TextOutput](#) --- this TextOutput itself, useful for chaining\n\n*** ** * ** ***\n\n### `download``As``File(filename)`\n\nTells browsers to download rather than display this content.\n\nSome browsers will ignore this setting. Setting this to null will clear it back to the\ndefault behavior of displaying rather than downloading.\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|----------|-----------------------------------------|\n| `filename` | `String` | the filename to tell the browser to use |\n\n#### Return\n\n\n[TextOutput](#) --- the TextOutput object, useful for chaining\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the filename contains illegal characters\n\n*** ** * ** ***\n\n### `get``Content()`\n\nGets the content that will be served.\n\n#### Return\n\n\n`String` --- the content that will be served\n\n*** ** * ** ***\n\n### `get``File``Name()`\n\nReturns the file name to download this file as, or null if it should be displayed rather than\ndownloaded.\n\n#### Return\n\n\n`String` --- the file name\n\n*** ** * ** ***\n\n### `get``Mime``Type()`\n\nGet the mime type this content will be served with.\n\n#### Return\n\n\n[MimeType](/apps-script/reference/content/mime-type) --- the mime type this will be served with\n\n*** ** * ** ***\n\n### `set``Content(content)`\n\nSets the content that will be served.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|----------------------|\n| `content` | `String` | the content to serve |\n\n#### Return\n\n\n[TextOutput](#) --- this TextOutput itself, useful for chaining\n\n*** ** * ** ***\n\n### `set``Mime``Type(mimeType)`\n\nSets the mime type for content that will be served. The default is plain text.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|------------------------------------------------------|---------------|\n| `mime``Type` | [MimeType](/apps-script/reference/content/mime-type) | the mime type |\n\n#### Return\n\n\n[TextOutput](#) --- this TextOutput itself, useful for chaining"]]
