Class TextOutput
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Văn bảnKết quả
Một đối tượng TextOutput có thể được phân phát từ tập lệnh.
Do các cân nhắc về bảo mật, tập lệnh không thể trực tiếp trả về nội dung văn bản cho trình duyệt.
Thay vào đó, trình duyệt sẽ được chuyển hướng đến googleusercontent.com. Trình duyệt này sẽ hiển thị nội dung đó mà không cần làm sạch hoặc thao tác thêm.
Bạn có thể trả về nội dung văn bản như sau:
function doGet() {
return ContentService.createTextOutput('hello world!');
}
Cũng có các phương thức để phân phát JSON, RSS và XML dưới dạng TextOutput; hãy xem các phương thức tương ứng trên
ContentService.
Tài liệu chi tiết
append(addedContent)
Thêm nội dung mới vào nội dung sẽ được phân phát.
Tham số
| Tên | Loại | Mô tả |
addedContent | String | nội dung cần thêm vào |
Cầu thủ trả bóng
TextOutput – chính TextOutput này, hữu ích cho việc tạo chuỗi
clear()
Xoá nội dung hiện tại.
Cầu thủ trả bóng
TextOutput – chính TextOutput này, hữu ích cho việc tạo chuỗi
downloadAsFile(filename)
Yêu cầu trình duyệt tải xuống thay vì hiển thị nội dung này.
Một số trình duyệt sẽ bỏ qua chế độ cài đặt này. Việc đặt giá trị này thành rỗng sẽ xoá giá trị này về hành vi mặc định là hiển thị thay vì tải xuống.
Tham số
| Tên | Loại | Mô tả |
filename | String | tên tệp để yêu cầu trình duyệt sử dụng |
Cầu thủ trả bóng
TextOutput – đối tượng TextOutput, hữu ích cho việc tạo chuỗi
Gửi
Error – nếu tên tệp chứa ký tự không hợp lệ
getContent()
Lấy nội dung sẽ được phân phát.
Cầu thủ trả bóng
String – nội dung sẽ được phân phát
getFileName()
Trả về tên tệp để tải tệp này xuống hoặc giá trị rỗng nếu tệp này sẽ hiển thị thay vì tải xuống.
Cầu thủ trả bóng
String – tên tệp
getMimeType()
Lấy loại MIME mà nội dung này sẽ được phân phát.
Cầu thủ trả bóng
MimeType – loại mime sẽ được phân phát
setContent(content)
Đặt nội dung sẽ được phân phát.
Tham số
| Tên | Loại | Mô tả |
content | String | nội dung cần phân phát |
Cầu thủ trả bóng
TextOutput – chính TextOutput này, hữu ích cho việc tạo chuỗi
setMimeType(mimeType)
Đặt loại MIME cho nội dung sẽ được phân phát. Giá trị mặc định là văn bản thuần tuý.
Tham số
Cầu thủ trả bóng
TextOutput – chính TextOutput này, hữu ích cho việc tạo chuỗi
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\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"]]
