File and Directory Entries API
==============================

**비표준:** 이 기능은 비표준이므로 실제 프로덕션에서 사용하지 마세요. 모든 사용자 환경에서 작동하지 않을 수 도 있으며, 미래에 호환성 문제가 생길 수 있습니다.

The File and Directory Entries API는 탐색 및 파일 접근이 가능한 로컬 파일 시스템을 웹상에 시뮬레이션합니다. 이 API를 통해 당신은 읽고, 쓰고, 파일과 디렉토리를 생성할 수 있는 가상의 파일 시스템을 가진 앱을 개발할 수 있을 것입니다.

**참고:** 이 API는 아직 표준이 아니기 때문에, 모든 브라우저가 이를 지원하지 않는 다는 점을 유념하십시오. 지원하더라도 일부 기능만을 지원할 수도 있습니다. 자세한 내용은 브라우저 호환성(Browser compatibility) 항목을 참조하십시오.

동기적 혹은 비동기적인 동작 중 어느 쪽을 필요로 하냐에 따라 만들어진 매우 유사한 두 개의 API가 있습니다. 동기식 API는 `Worker` 내에서 사용될 수 있도록 확장되어 왔으며 당신이 원하는 값을 반환합니다. 비동기식 API는 브라우저의 동작을 방해하지 않지만 함수와 API가 값을 반환하지 않습니다; 그 대신, 당신은 콜백 함수를 이용해 언제든 응답을 처리할 수 있습니다.

**경고:** Firefox에 내장된 File and Directory Entries API는 매우 제한적입니다; 해당 환경에서는 파일 생성을 사용할 수 없습니다. `<input>` (en-US)이나 (`HTMLInputElement` (en-US) 도 확인하십시오) 앱이나 웹사이트에서 드래그 앤 드롭(drag and drop)을 통해 유저가 직접 선택한 파일에만 액세스 가능합니다. 또한 Firefox는 동기식 API 역시 지원하지 않습니다. API의 어떤 부분을 사용하려고 하든 반드시 브라우저 호환성을 확인하시고, Firefox에 대한 이 API의 호환성(File and Directory Entries API support in Firefox (en-US))을 통해 더 자세하게 알아보도록 하십시오.

파일 시스템에 접근하기
------------

현재로서 정의된 파일 시스템에 대한 접근 방법은 두 가지입니다:

* 드래그 앤 드롭(`drop` (en-US)) 이벤트를 제어함으로써, 당신은 `DataTransferItem.webkitGetAsEntry()` (en-US) 를 통해`FileSystemEntry` (en-US)에 드롭한 파일을 전달할 수 있습니다. 만일 결과가 `null`이 아니라면, 드롭한 파일 혹은 디렉토리를 파일 시스템에서 사용할 수 있을 것입니다.
* `HTMLInputElement.webkitEntries` (en-US) 속성은 당신이 `FileSystemFileEntry` (en-US) 객체에 현재 선택된 파일을 접근시킬 수 있게 하지만, 파일 선택기(File chooser)로 직접 드래그 앤 드롭한 경우에만 가능합니다. (Firefox bug 1326031). 만일 `HTMLInputElement.webkitdirectory` (en-US)의 값을 `true`로 두었다면, 디렉토리 선택자(Directory picker) 대신 `<input>` (en-US) 를 사용할 수 있고, 선택된 각 디렉토리에 대해 `FileSystemDirectoryEntry` (en-US) 객체로 만들 수 있습니다.
비동기식 API
--------

파일 시스템 액세스가 메인 스레드에서 사용될 경우 전체 브라우저를 차단하지 않도록 대부분의 작업은 비동기 API를 이용하여야 합니다. 다음과 같은 인터페이스를 포함하고 있습니다:

`FileSystem` (en-US)

파일 시스템을 나타냅니다.

`FileSystemEntry` (en-US)

파일 시스템의 단일 엔트리를 의미하는 기본적인 인터페이스입니다. 이것은 파일이나 디렉토리 등을 나타내는 다른 인터페이스들에 의해 구현됩니다.

`FileSystemFileEntry` (en-US)

파일 시스템 내의 단일 파일을 나타냅니다.

`FileSystemDirectoryEntry` (en-US)

파일 시스템 내의 단일 디렉토리를 나타냅니다.

`FileSystemDirectoryReader` (en-US)

`FileSystemDirectoryEntry.createReader()` (en-US)를 호출함으로써 만들어지는 인터페이스이며, 디렉토리의 내용물을 읽을 수 있는 기능을 제공합니다.

`FileSystemFlags` (en-US)

File and Directory Entries API에서 특정 메소드를 호출할 때 옵션 플래그로 사용되는 값들의 집합을 정의합니다.

`FileError` 
지원이 중단되었습니다

비동기 파일 시스템 호출에 의해 발생한 에러를 나타냅니다.

또한 두 개의 전역 함수가 있습니다(현재로선 명세화되지 않아 Google Chrome에만 내장되어 있습니다). `Window` 객체 위에서 사용 가능하며 `LocalFileSystem` (en-US)에 구현되어 있습니다: 각각 `requestFileSystem()` 과 `resolveLocalFileSystemURL()`.

동기식 API
-------

동기식 API는 반드시 `Worker`s 안에서만 사용되어야 합니다; 이 호출들은 그들이 실행이 완료될 때 까지 브라우저의 동작을 멈추며, 콜백을 보내는 대신 단순히 결과값을 반환합니다. 이 함수들을 메인 스레드에서 사용하는 것은 브라우저의 동작을 멈출 것이며, 그것은 너무 난잡한 방식입니다. 아래의 인터페이스들은 비동기식 API와 기능적으로 거의 유사합니다.

`FileSystemSync` (en-US)

파일 시스템을 나타냅니다.

`FileSystemEntrySync` (en-US)

파일 시스템의 단일 엔트리를 의미하는 기본적인 인터페이스입니다. 이것은 파일이나 디렉토리 등을 나타내는 다른 인터페이스들에 의해 구현됩니다.

`FileSystemFileEntrySync`

파일 시스템 내의 단일 파일을 나타냅니다.

`FileSystemDirectoryEntrySync`

파일 시스템 내의 단일 디렉토리를 나타냅니다.

`FileSystemDirectoryReaderSync`

`FileSystemDirectoryEntrySync.createReader()`를 호출함으로써 만들어지는 인터페이스이며, 디렉토리의 내용물을 읽을 수 있는 기능을 제공합니다.

`FileException` (en-US) 
지원이 중단되었습니다

동기 파일 시스템 호출에 의해 발생한 에러를 나타냅니다.

또한 두 개의 전역 함수가 있습니다(현재로선 명세화되지 않아 Google Chrome에만 내장되어 있습니다). `Worker` 객체 위에서 사용 가능하며 `LocalFileSystemSync` (en-US)에 구현되어 있습니다: 각각 `requestFileSystemSync()` 과 `resolveLocalFileSystemSyncURL()`.

기타 인터페이스
--------

`LocalFileSystem` (en-US)
샌드박스 파일 시스템에 접근할 수 있습니다.
`LocalFileSystemSync` (en-US)

`LockedFile` (en-US)
필요한 모든 잠금을 사용하여 주어진 파일을 처리할 수 있는 도구를 제공합니다.
`Metadata` (en-US)
Experimental

명세
--

| Specification |
| --- |
| File and Directory Entries API # api-domfilesystem |

브라우저 호환성
--------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

같이 보기
-----

* File and Directory Entries API 소개(Introduction to the File and Directory Entries API (en-US))
* Firefox에 대한 File and Directory Etnries API의 호환성(File and Directory Entries API support in Firefox (en-US))