Window 인터페이스의showSaveFilePicker() 메서드는 사용자가기존 파일을 선택하거나, 새로운 파일 이름을 입력해서 파일을 저장할 수 있는선택창을 엽니다.

구문

showSaveFilePicker()

매개변수

optionsOptional

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

excludeAcceptAllOptionOptional

기본 값false인 불리언입니다.기본적으로 파일 선택창에는 파일 유형 필터(아래의type 참고)를적용하지 않는 옵션이 존재합니다. 이 옵션을true로 설정하면사용자가 해당 옵션을 선택할 수 없습니다.

idOptional

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

startInOptional

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

suggestedNameOptional

추천하는 파일 이름을 지정하는String입니다.

typesOptional

저장 가능한 파일 유형들의Array입니다.각 요소는 아래의 옵션을 포함하는 객체입니다.

descriptionOptional

사용 가능한 파일 유형에 대한 설명입니다.기본 값은 빈 문자열입니다.

accept

키는MIME 유형이고 값은 파일 확장자들의Array인Object입니다(아래 예제를 참고하세요).

반환 값

FileSystemFileHandle 객체로 이행하는Promise.

예외

• AbortErrorDOMException
  • : 사용자가 파일을 선택하지 않고 선택창을 닫았을 때, 또는 사용자 에이전트가 판단했을 때파일이 너무 민감하거나 위험할 때 발생합니다.
  • SecurityErrorDOMException
  • :동일 출처 정책에 의해 호출이 차단됐거나, 버튼 클릭과 같은 사용자 상호작용에 의해 호출된 것이 아니라면 발생합니다.
• TypeError
  • : 다음과 같은 상황에 의해 허용하는 파일 유형을 처리할 수 없으면 발생합니다.
    • types 옵션의accept 옵션 내 어떤 키가 유효한 MIME 유형이 아닌 경우.
    • types 옵션의accept 옵션 내 어떤 값이 유효하지 않은 경우, 예컨대.로 시작하지 않거나,.로 끝나거나, 유효하지 않은 코드 포인트를 포함하거나, 길이가 16 초과할 때.
    • types 옵션이 비어있는데excludeAcceptAllOption 옵션이true인 경우.

보안

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

예제

다음 코드는 텍스트 파일들을 선택할 수 있는 파일 선택창을 엽니다.

async function getNewFileHandle() {  const opts = {    types: [      {        description: "Text file",        accept: { "text/plain": [".txt"] },      },    ],  };  return await window.showSaveFilePicker(opts);}

명세서

브라우저 호환성

같이 보기

• File System API
• The File System Access API: simplifying access to local files