Window: showDirectoryPicker() 메서드

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

보안 컨텍스트: 이 기능은 일부 또는 모든 지원 브라우저보안 컨텍스트 (HTTPS)에서만 사용할 수 있습니다.

실험적: 이 기능은 실험적인 기능입니다.
프로덕션 환경에서 사용하기 전에 브라우저 호환성 표를 주의 깊게 확인하세요.

Window 인터페이스의 showDirectoryPicker() 메서드는 사용자가 디렉터리 한 개를 선택할 수 있는 디렉터리 선택창을 엽니다.

구문

js
showDirectoryPicker()

매개변수

options Optional

아래의 옵션을 포함하는 객체입니다.

id Optional

ID를 지정하면 브라우저가 선택창의 ID마다 마지막으로 탐색한 디렉터리를 기억합니다. 다른 선택창에서 같은 ID를 사용한다면, 이전에 해당 ID로 탐색했던 디렉터리에서 선택창이 열립니다.

mode Optional

디렉터리에 대한 읽기 전용 접근 시 "read", 읽기와 쓰기 모두 가능한 접근 시 "readwrite"이어야 합니다. 기본 값은 "read"입니다.

startIn Optional

선택창이 열릴 때의 최초 디렉터리를 가리키는 FileSystemHandle, 또는 널리 알려진 디렉터리 식별자("desktop", "documents", "downloads", "music", "pictures", 또는 "videos")입니다.

반환 값

FileSystemDirectoryHandle 객체로 이행하는 Promise.

예외

AbortError DOMException

사용자가 디렉터리를 선택하지 않고 선택창을 닫았을 때, 사용자 에이전트가 판단했을 때 디렉터리가 너무 민감하거나 위험할 때, 또는 지정한 mode 옵션에 대해 선택한 디렉터리의 PermissionStatus.state"granted"가 아닐 때 발생합니다.

SecurityError DOMException

동일 출처 정책에 의해 호출이 차단됐거나, 버튼 클릭과 같은 사용자 상호작용에 의해 호출된 것이 아니라면 발생합니다.

보안

사용자의 임시 활성화가 필요합니다. 이 기능이 동작하려면 사용자가 페이지 또는 UI 요소와 상호작용해야 합니다.

예제

다음 비동기 함수는 디렉터리 선택창을 열고, 사용자가 디렉터리를 선택한 후에 FileSystemDirectoryHandle를 반환합니다.

js
async function getDir() {
  const dirHandle = await window.showDirectoryPicker();

  // dirHandle을 사용하는 코드들
}

명세서

Specification
File System Access
# api-showdirectorypicker

브라우저 호환성

BCD tables only load in the browser

같이 보기