Class TextOutput
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
النصالإخراج
عنصر TextOutput يمكن عرضه من نص برمجي.
لا يمكن للنصوص البرمجية عرض محتوى نصي مباشرةً في المتصفّح، وذلك لأسباب تتعلق بالأمان.
بدلاً من ذلك، تتم إعادة توجيه المتصفّح إلى googleusercontent.com الذي سيعرضه بدون أي
مزيد من عمليات التطهير أو التلاعب.
يمكنك عرض محتوى نصي على النحو التالي:
function doGet() {
return ContentService.createTextOutput('hello world!');
}
تتوفّر أيضًا طرق لعرض JSON وRSS وXML كمخرجات نصية. اطّلِع على الطرق المقابلة
في
ContentService.
مستندات تفصيلية
append(addedContent)
إلحاق محتوى جديد بالمحتوى الذي سيتم عرضه
المعلمات
| الاسم | النوع | الوصف |
addedContent | String | المحتوى الذي تريد إلحاقه |
الإرجاع
TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل
clear()
يؤدي إلى محو المحتوى الحالي.
الإرجاع
TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل
downloadAsFile(filename)
يطلب من المتصفّحات تنزيل هذا المحتوى بدلاً من عرضه.
ستتجاهل بعض المتصفّحات هذا الإعداد. سيؤدي ضبط هذا الخيار على "قيمة فارغة" إلى إعادة ضبطه على السلوك
التلقائي للعرض بدلاً من التنزيل.
المعلمات
| الاسم | النوع | الوصف |
filename | String | اسم الملف الذي تريد إبلاغ المتصفّح باستخدامه |
الإرجاع
TextOutput - عنصر TextOutput، وهو مفيد لإنشاء سلاسل
عمليات الرمي
Error - إذا كان اسم الملف يحتوي على أحرف غير صالحة
getContent()
تحصل على المحتوى الذي سيتم عرضه.
الإرجاع
String: المحتوى الذي سيتم عرضه
getFileName()
تعرِض هذه السمة اسم الملف الذي سيتم تنزيله به، أو قيمة فارغة إذا كان من المفترض عرضه بدلاً من تنزيله.
الإرجاع
String: اسم الملف
getMimeType()
الحصول على نوع MIME الذي سيتم عرض هذا المحتوى به
الإرجاع
MimeType: نوع MIME الذي سيتم عرضه به
setContent(content)
لضبط المحتوى الذي سيتم عرضه.
المعلمات
| الاسم | النوع | الوصف |
content | String | المحتوى المطلوب عرضه |
الإرجاع
TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل
setMimeType(mimeType)
لضبط نوع MIME للمحتوى الذي سيتم عرضه. الإعداد التلقائي هو النص العادي.
المعلمات
| الاسم | النوع | الوصف |
mimeType | MimeType | نوع MIME |
الإرجاع
TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]
