-
Notifications
You must be signed in to change notification settings - Fork 8.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: A1lo <[email protected]>
- Loading branch information
1 parent
f73dd4a
commit e8effd2
Showing
1 changed file
with
14 additions
and
15 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,41 +1,40 @@ | ||
--- | ||
title: FileSystem | ||
slug: Web/API/FileSystem | ||
l10n: | ||
sourceCommit: 0c3f18aca2c8a93d3982183f64bf7762c2c310b0 | ||
--- | ||
|
||
{{APIRef("File System API")}} {{non-standard_header}} | ||
{{APIRef("File and Directory Entries API")}} | ||
|
||
**`FileSystem`** 實作文件和目錄介面,描述一個檔案系統。在任何檔案系統上,這個物件包含 {{domxref("FileSystemEntry.filesystem", "filesystem")}}的特性。某些網頁瀏覽器提供額外的 API 去創建和管理檔案系統,如 Google Chrome 的{{domxref("LocalFileSystem.requestFileSystem", "requestFileSystem()")}}函式。 | ||
檔案與目錄 API 的 **`FileSystem`** 介面用來表示檔案系統。這些物件可從任何檔案系統項目上的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性取得。某些網頁瀏覽器提供額外的 API 去建立和管理檔案系統,例如 Google Chrome 的 {{domxref("Window.requestFileSystem", "requestFileSystem()")}} 方法。 | ||
|
||
> [!NOTE] | ||
> 此介面並非標準 API, 代表規格並未依造標準制定, 因此必須注意並非所有網頁瀏覽器都有實作此介面, 有實作的網頁瀏覽器可能只有實作一小部分. 請在[Browser compatibility](#browser_compatibility) 查看更多細節. | ||
此介面並不會讓你直接存取使用者電腦的檔案系統,而是在瀏覽器的沙盒內建立一個「虛擬磁碟」讓你操作。如果要直接操作使用者的檔案系統,需要向使用者請求,像是安裝 Google Chrome 擴充功能之類的。相關的 Chrome API 可[在此](https://developer.chrome.com/docs/apps/reference/fileSystem)找到。 | ||
|
||
## 基礎概念 | ||
|
||
存取 `FileSystem` 物件的兩種方法: | ||
存取 `FileSystem` 物件的兩種方法: | ||
|
||
1. 你可以直接要求一個使用`window.requestFileSystem(),`只用在你的網頁應用程式的沙盒類型 `FileSystem 物件。如果要求成功,將會執行`callback handler 去接收描述檔案系統的`FileSystem物件參數。` | ||
2. 你可以從檔案系統接口物件取得,透過他的{{domxref("FileSystemEntry.filesystem", "filesystem")}}特性 | ||
1. 你可以呼叫 `window.requestFileSystem()`,為你的網頁應用程式建立一個檔案系統的沙盒。如果呼叫成功,將會執行回呼函式,該回呼函式會有個 `FileSystem` 參數來描述檔案系統。 | ||
2. 從檔案系統項目物件的 {{domxref("FileSystemEntry.filesystem", "filesystem")}} 屬性中取得。 | ||
|
||
## 屬性 | ||
## 實例屬性 | ||
|
||
- {{domxref("FileSystem.name")}} {{ReadOnlyInline}} | ||
- : {{domxref("USVString")}} 代表檔案系統的名稱. 此名稱在整個已宣告的檔案系統清單中是唯一的。 | ||
- : 代表檔案系統名稱的字串。此名稱在整個檔案的清單中是唯一的。 | ||
- {{domxref("FileSystem.root")}} {{ReadOnlyInline}} | ||
- : {{domxref("FileSystemDirectoryEntry")}} 物件表示檔案系統的根目錄。 透過此物件, 你可以取得權限存取所有檔案系統中的文件和目錄 | ||
- : 為一個 {{domxref("FileSystemDirectoryEntry")}} 物件,用來表示檔案系統的根目錄。透過此物件,你可以取得檔案系統中的所有的檔案與目錄。 | ||
|
||
## 規範 | ||
|
||
{{Specifications}} | ||
|
||
This API has no official W3C or WHATWG specification. | ||
|
||
## 瀏覽器相容性 | ||
|
||
{{Compat}} | ||
|
||
## 參見 | ||
|
||
- [File and Directory Entries API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API) | ||
- [Introduction to the File System API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) | ||
- {{domxref("FileSystemEntry")}}, {{domxref("FileSystemFileEntry")}}, and {{domxref("FileSystemDirectoryEntry")}} | ||
- [檔案與目錄 API](/zh-TW/docs/Web/API/File_and_Directory_Entries_API) | ||
- [檔案與目錄 API 介紹](/zh-TW/docs/Web/API/File_and_Directory_Entries_API/Introduction) | ||
- {{domxref("FileSystemEntry")}}、{{domxref("FileSystemFileEntry")}}、{{domxref("FileSystemDirectoryEntry")}} |