Skip to content

Commit

Permalink
[zh-tw] update filesystem (#23069)
Browse files Browse the repository at this point in the history
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <[email protected]>
  • Loading branch information
3 people authored Aug 28, 2024
1 parent f73dd4a commit e8effd2
Showing 1 changed file with 14 additions and 15 deletions.
29 changes: 14 additions & 15 deletions files/zh-tw/web/api/filesystem/index.md
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")}}

0 comments on commit e8effd2

Please sign in to comment.