chrome.fileSystemProvider

설명

chrome.fileSystemProvider API를 사용하여 파일 시스템을 만들 수 있습니다. 파일 시스템은 Chrome OS의 파일 관리자에서 액세스할 수 있습니다.

권한

fileSystemProvider

지원 대상

ChromeOS만 해당

File System Provider API를 사용하려면 확장 프로그램 매니페스트에서 'fileSystemProvider' 권한과 섹션을 선언해야 합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

file_system_provider 섹션은 다음과 같이 선언해야 합니다.

configurable (불리언) - 선택사항
onConfigureRequested를 통한 구성 지원 여부입니다. 기본값은 false입니다.
multiple_mounts (불리언) - 선택사항
마운트된 파일 시스템 여러 개 (2개 이상)의 지원 여부입니다. 기본값은 false입니다.
watchable (불리언) - 선택사항
감시자 설정 및 변경사항 알림 지원 여부입니다. 기본값은 false입니다.
source('file', 'device' 또는 'network')의 열거형 - 필수
마운트된 파일 시스템의 데이터 소스입니다.

Files 앱은 관련 UI 요소를 적절하게 렌더링하기 위해 위의 정보를 사용합니다. 예를 들어 configurable를 true로 설정하면 볼륨 구성을 위한 메뉴 항목이 렌더링됩니다. 마찬가지로 multiple_mounts가 true로 설정되면 Files 앱이 UI에서 마운트 지점을 두 개 이상 추가할 수 있습니다. watchable이 false이면 새로고침 버튼이 렌더링됩니다. 가능하면 감시자 지원을 추가해야 파일 시스템의 변경사항이 즉시 자동으로 반영될 수 있습니다.

개요

File System Provider API를 사용하면 확장 프로그램이 ChromeOS의 파일 관리자에서 제공되는 가상 파일 시스템을 지원할 수 있습니다. 사용 사례로는 보관 파일 압축 풀기 및 Drive 이외의 클라우드 서비스의 파일 액세스 등이 있습니다.

파일 시스템 마운트

확장 프로그램을 제공하면 외부 소스 (예: 원격 서버 또는 USB 기기)의 파일 시스템 콘텐츠를 제공하거나 로컬 파일 (예: 보관 파일)을 입력으로 사용할 수 있습니다.

파일 핸들러 (소스는 "file")인 파일 시스템을 작성하려면 onLaunched 이벤트를 확장 프로그램에 사용할 수 없으므로 제공자가 패키징된 앱이어야 합니다.

소스가 네트워크 또는 기기인 경우 onMountRequested 이벤트가 호출될 때 파일 시스템이 마운트되어야 합니다.

파일 시스템 데이터의 소스 진입점
"file" 패키지 앱에서만 사용할 수 있습니다.
"device" 또는 "network" onMountRequested

파일 시스템 구성

마운트된 후에는 제공된 파일 시스템이 onConfigureRequested 이벤트를 통해 구성될 수 있습니다. 특히 올바른 자격 증명을 설정하기 위해 네트워크를 통해 콘텐츠를 제공하는 파일 시스템에 유용합니다. 이 이벤트를 처리하는 것은 선택사항입니다.

수명 주기

제공된 파일 시스템은 마운트 후 Chrome에 저장되어 재부팅 또는 재시작 후 자동으로 다시 마운트됩니다. 따라서 확장 프로그램을 제공하여 파일 시스템이 마운트되면 확장 프로그램이 로드 해제되거나 확장 프로그램이 마운트 해제 메서드를 호출할 때까지 유지됩니다.

유형

AbortRequestedOptions

속성

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • operationRequestId

    숫자

    취소할 요청의 ID입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

Action

Chrome 45 이상

속성

  • id

    문자열

    작업의 식별자입니다. 임의의 문자열 또는 CommonActionId(일반적인 작업의 경우)

  • title

    문자열 선택사항

    작업의 제목입니다. 일반적인 작업에서는 무시될 수 있습니다.

AddWatcherRequestedOptions

속성

  • entryPath

    문자열

    관찰할 항목의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • recursive

    boolean

    관찰에 모든 하위 항목이 재귀적으로 포함되어야 하는지 여부입니다. 디렉터리에만 적용될 수 있습니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

Change

속성

  • changeType

    ChangeType

    항목에 발생한 변경 유형입니다.

  • cloudFileInfo

    CloudFileInfo 선택사항

    대기중

    클라우드 파일 시스템에서 지원하는 경우 파일과 관련된 정보입니다.

  • entryPath

    문자열

    변경된 항목의 경로입니다.

ChangeType

관찰된 디렉터리에서 감지된 변경사항의 유형입니다.

enum

CloseFileRequestedOptions

속성

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • openRequestId

    숫자

    파일을 여는 데 사용되는 요청 ID입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

CloudFileInfo

대기중

속성

  • versionTag

    문자열 선택사항

    파일의 버전을 나타내는 태그.

CloudIdentifier

Chrome 117 이상

속성

  • id

    문자열

    지정된 파일/디렉터리의 제공자 식별자입니다.

  • providerName

    문자열

    클라우드 저장소 제공업체의 식별자입니다 (예: 'drive.google.com').

CommonActionId

Chrome 45 이상

일반적인 작업 목록입니다. "SHARE"에서는 다른 사람과 파일을 공유할 수 있습니다. 고정을 위한 "SAVE_FOR_OFFLINE" (오프라인 액세스를 위해 저장) "OFFLINE_NOT_NECESSARY": 오프라인 액세스를 위해 더 이상 파일을 저장할 필요가 없음을 알리는 데 사용됩니다. onGetActionsRequested 및 onExecuteActionRequested에서 사용됩니다.

enum

ConfigureRequestedOptions

Chrome 44 이상

속성

  • fileSystemId

    문자열

    구성할 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

CopyEntryRequestedOptions

속성

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

  • sourcePath

    문자열

    복사할 항목의 소스 경로입니다.

  • targetPath

    문자열

    복사 작업의 대상 경로입니다.

CreateDirectoryRequestedOptions

속성

  • directoryPath

    문자열

    생성할 디렉터리의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • recursive

    boolean

    작업의 재귀 여부입니다 (디렉터리에만 해당).

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

CreateFileRequestedOptions

속성

  • filePath

    문자열

    생성할 파일의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

DeleteEntryRequestedOptions

속성

  • entryPath

    문자열

    삭제할 항목의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • recursive

    boolean

    작업의 재귀 여부입니다 (디렉터리에만 해당).

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

EntryMetadata

속성

  • cloudFileInfo

    CloudFileInfo 선택사항

    대기중

    기본 클라우드 파일 시스템에 있는 특정 파일을 식별하는 정보입니다. options에서 요청되고 파일이 클라우드 스토리지에서 지원되는 경우 제공해야 합니다.

  • cloudIdentifier

    CloudIdentifier 선택사항

    Chrome 117 이상

    이 항목의 Cloud Storage 표현입니다. options에서 요청되고 파일이 클라우드 스토리지에서 지원되는 경우 제공해야 합니다. 클라우드 스토리지에서 지원하지 않는 로컬 파일의 경우 요청 시 정의되지 않아야 합니다.

  • isDirectory

    부울 선택사항

    디렉터리인 경우 true입니다. options에서 요청하는 경우 제공해야 합니다.

  • mimeType

    문자열 선택사항

    항목의 Mime 유형입니다. 항상 선택사항이지만 options에서 요청하는 경우 제공해야 합니다.

  • modificationTime

    날짜(선택사항)

    이 항목의 최종 수정 시간입니다. options에서 요청하는 경우 제공해야 합니다.

  • 이름

    문자열 선택사항

    이 항목의 이름입니다 (전체 경로 이름 아님). '/'를 포함해서는 안 됩니다. 루트의 경우 비어 있어야 합니다. options에서 요청하는 경우 제공해야 합니다.

  • 크기

    number 선택사항

    바이트 단위의 파일 크기입니다. options에서 요청하는 경우 제공해야 합니다.

  • 썸네일

    문자열 선택사항

    PNG, JPEG 또는 WEBP 형식의 데이터 URI로서의 썸네일 이미지 크기는 최대 32KB입니다. 선택사항이지만 onGetMetadataRequested 이벤트에서 명시적으로 요청한 경우에만 제공될 수 있습니다.

ExecuteActionRequestedOptions

Chrome 45 이상

속성

  • actionId

    문자열

    실행할 작업의 식별자입니다.

  • entryPaths

    문자열[]

    Chrome 47 이상

    작업에 사용할 항목의 경로 집합입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

FileSystemInfo

속성

  • displayName

    문자열

    사람이 읽을 수 있는 파일 시스템 이름입니다.

  • fileSystemId

    문자열

    파일 시스템의 식별자입니다.

  • openedFiles

    OpenedFile[]

    현재 열려 있는 파일 목록입니다.

  • openedFilesLimit

    숫자

    한 번에 열 수 있는 최대 파일 수입니다. 0인 경우 제한이 적용되지 않습니다.

  • supportsNotifyTag

    부울 선택사항

    Chrome 45 이상

    파일 시스템이 디렉터리 관찰을 위한 tag 필드를 지원하는지 여부입니다.

  • 감시자

    감시자[]

    Chrome 45 이상

    감시자 목록입니다.

  • 쓰기 가능

    boolean

    파일 시스템이 파일 시스템의 콘텐츠를 변경할 수 있는 작업 (예: 파일 만들기, 삭제, 쓰기)을 지원하는지 여부입니다.

GetActionsRequestedOptions

Chrome 45 이상

속성

  • entryPaths

    문자열[]

    Chrome 47 이상

    작업 목록의 항목 경로 목록입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

GetMetadataRequestedOptions

속성

  • cloudFileInfo

    boolean

    대기중

    cloudFileInfo 값이 요청되면 true로 설정합니다.

  • cloudIdentifier

    boolean

    Chrome 117 이상

    cloudIdentifier 값이 요청되면 true로 설정합니다.

  • entryPath

    문자열

    메타데이터를 가져올 항목의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • isDirectory

    boolean

    Chrome 49 이상

    is_directory 값이 요청되면 true로 설정합니다.

  • mimeType

    boolean

    Chrome 49 이상

    mimeType 값이 요청되면 true로 설정합니다.

  • modificationTime

    boolean

    Chrome 49 이상

    modificationTime 값이 요청되면 true로 설정합니다.

  • 이름

    boolean

    Chrome 49 이상

    name 값이 요청되면 true로 설정합니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

  • 크기

    boolean

    Chrome 49 이상

    size 값이 요청되면 true로 설정합니다.

  • 썸네일

    boolean

    thumbnail 값이 요청되면 true로 설정합니다.

MountOptions

속성

  • displayName

    문자열

    사람이 읽을 수 있는 파일 시스템 이름입니다.

  • fileSystemId

    문자열

    파일 시스템의 문자열 식별자. 각 확장 프로그램마다 고유해야 합니다.

  • openedFilesLimit

    number 선택사항

    한 번에 열 수 있는 최대 파일 수입니다. 지정되지 않은 경우 또는 0으로 제한되지 않습니다.

  • 영구

    부울 선택사항

    Chrome 64 이상

    프레임워크가 다음 로그인 세션에서 파일 시스템을 재개해야 하는지 여부입니다. 기본적으로 true입니다.

  • supportsNotifyTag

    부울 선택사항

    Chrome 45 이상

    파일 시스템이 관찰된 디렉터리에 대해 tag 필드를 지원하는지 여부입니다.

  • 쓰기 가능

    부울 선택사항

    파일 시스템이 파일 시스템의 콘텐츠를 변경할 수 있는 작업 (예: 파일 만들기, 삭제, 쓰기)을 지원하는지 여부입니다.

MoveEntryRequestedOptions

속성

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

  • sourcePath

    문자열

    새 위치로 이동할 항목의 소스 경로입니다.

  • targetPath

    문자열

    복사 작업의 대상 경로입니다.

NotifyOptions

속성

  • changeType

    ChangeType

    관찰된 항목에 발생한 변경 유형입니다. 삭제된 경우 관찰된 항목이 관찰된 항목 목록에서 자동으로 삭제됩니다.

  • 변경사항

    변경[] 선택사항

    관찰된 디렉터리 내의 항목 변경사항 목록 (항목 자체 포함)

  • fileSystemId

    문자열

    이 변경사항과 관련된 파일 시스템의 식별자입니다.

  • observedPath

    문자열

    관찰된 항목의 경로입니다.

  • recursive

    boolean

    관찰된 항목의 모드입니다.

  • 태그

    문자열 선택사항

    알림에 대한 태그입니다. 파일 시스템이 supportsNotifyTag 옵션으로 마운트된 경우 필수입니다. 참고로, 이 플래그는 시스템이 종료되었을 때도 변경된 사항에 대한 알림을 제공하는 데 필요합니다.

OpenedFile

속성

  • filePath

    문자열

    열린 파일의 경로입니다.

  • 모드

    OpenFileMode

    파일이 읽기 또는 쓰기를 위해 열렸는지 여부입니다.

  • openRequestId

    숫자

    연속 읽기/쓰기 및 닫기 요청에 사용할 요청 ID입니다.

OpenFileMode

파일을 여는 모드입니다. onOpenFileRequested에서 사용됩니다.

enum

OpenFileRequestedOptions

속성

  • filePath

    문자열

    열 파일의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • 모드

    OpenFileMode

    파일을 읽기 또는 쓰기에 사용할지 여부입니다.

  • requestId

    숫자

    연속적인 읽기/쓰기 및 닫기 요청에 사용될 요청 ID입니다.

ProviderError

요청에 응답하여 확장 프로그램을 제공하거나 API의 메서드를 호출할 때 오류가 발생하는 경우에 사용하는 오류 코드입니다. 성공하려면 "OK"를 사용해야 합니다.

enum

ReadDirectoryRequestedOptions

속성

  • directoryPath

    문자열

    콘텐츠가 요청된 디렉터리의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • isDirectory

    boolean

    Chrome 49 이상

    is_directory 값이 요청되면 true로 설정합니다.

  • mimeType

    boolean

    Chrome 49 이상

    mimeType 값이 요청되면 true로 설정합니다.

  • modificationTime

    boolean

    Chrome 49 이상

    modificationTime 값이 요청되면 true로 설정합니다.

  • 이름

    boolean

    Chrome 49 이상

    name 값이 요청되면 true로 설정합니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

  • 크기

    boolean

    Chrome 49 이상

    size 값이 요청되면 true로 설정합니다.

  • 썸네일

    boolean

    Chrome 49 이상

    thumbnail 값이 요청되면 true로 설정합니다.

ReadFileRequestedOptions

속성

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • length

    숫자

    반환할 바이트 수입니다.

  • 오프셋

    숫자

    읽기를 시작할 파일의 위치 (바이트)입니다.

  • openRequestId

    숫자

    파일을 여는 데 사용되는 요청 ID입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

RemoveWatcherRequestedOptions

속성

  • entryPath

    문자열

    감시된 항목의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • recursive

    boolean

    감시자 모드입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

TruncateRequestedOptions

속성

  • filePath

    문자열

    잘라낼 파일의 경로입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • length

    숫자

    작업이 완료된 후 보관할 바이트 수입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

UnmountOptions

속성

  • fileSystemId

    문자열

    마운트 해제할 파일 시스템의 식별자입니다.

UnmountRequestedOptions

속성

  • fileSystemId

    문자열

    마운트 해제할 파일 시스템의 식별자입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

Watcher

속성

  • entryPath

    문자열

    관찰되는 항목의 경로입니다.

  • lastTag

    문자열 선택사항

    감시자의 마지막 알림에서 사용하는 태그입니다.

  • recursive

    boolean

    감시에 모든 하위 항목이 재귀적으로 포함되어야 하는지 여부입니다. 디렉터리에만 적용될 수 있습니다.

WriteFileRequestedOptions

속성

  • 데이터

    ArrayBuffer

    파일에 쓸 바이트의 버퍼입니다.

  • fileSystemId

    문자열

    이 작업과 관련된 파일 시스템의 식별자입니다.

  • 오프셋

    숫자

    파일에서 바이트 쓰기를 시작할 위치 (바이트)입니다.

  • openRequestId

    숫자

    파일을 여는 데 사용되는 요청 ID입니다.

  • requestId

    숫자

    이 요청의 고유 식별자입니다.

방법

get()

프로미스 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

전달된 fileSystemId가 있는 파일 시스템에 관한 정보를 반환합니다.

매개변수

  • fileSystemId

    문자열

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (fileSystem: FileSystemInfo)=>void

반환 값

  • Promise<FileSystemInfo>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getAll()

프로미스 
chrome.fileSystemProvider.getAll(
  callback?: function,
)

확장 프로그램에 의해 마운트된 모든 파일 시스템을 반환합니다.

매개변수

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (fileSystems: FileSystemInfo[])=>void

반환 값

  • Promise<FileSystemInfo[]>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

mount()

프로미스 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

지정된 fileSystemId 및 displayName로 파일 시스템을 마운트합니다. 파일 앱의 왼쪽 패널에 displayName이(가) 표시됩니다. displayName에는 '/'를 포함한 모든 문자가 포함될 수 있지만 빈 문자열을 입력할 수는 없습니다. displayName은 설명적이어야 하지만 고유하지 않아도 됩니다. fileSystemId은(는) 빈 문자열이 아니어야 합니다.

마운트되는 파일 시스템의 유형에 따라 source 옵션을 적절하게 설정해야 합니다.

오류가 발생하면 runtime.lastError가 해당 오류 코드와 함께 설정됩니다.

매개변수

  • 옵션

    MountOptions

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

notify()

Promise Chrome 45 이상 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

recursive 모드에서 observedPath에 있는 감시된 디렉터리의 변경사항을 알립니다. 파일 시스템이 supportsNotifyTag로 마운트된 경우 tag를 제공해야 하며 시스템이 종료된 경우에도 마지막 알림 이후의 모든 변경사항이 항상 보고되어야 합니다. 마지막 태그는 getAll로 가져올 수 있습니다.

사용하려면 file_system_provider.notify 매니페스트 옵션을 true로 설정해야 합니다.

tag 값은 호출별로 고유한 모든 문자열이 될 수 있으므로 마지막으로 등록된 알림을 식별할 수 있습니다. 예를 들어 확장 프로그램 제공이 재부팅 후 시작되고 마지막으로 등록된 알림의 태그가 '123'인 경우 변경사항에 '123'으로 태그된 이후 발생한 모든 변경사항에 대해 notify를 호출해야 합니다. 빈 문자열일 수 없습니다.

일부 제공자가 태그를 제공할 수 있는 것은 아니지만 파일 시스템에 변경 로그가 있는 경우 태그는 변경 번호나 버전 번호 등이 될 수 있습니다.

상위 디렉터리가 삭제되면 모든 하위 항목도 삭제되며, 감시할 경우 API에 이 사실을 알려야 합니다. 또한 디렉터리의 이름이 바뀌면 원래 경로 아래에 항목이 더 이상 없으므로 모든 하위 항목이 실제로 삭제됩니다.

오류가 발생하면 runtime.lastError가 해당 오류 코드로 설정됩니다.

매개변수

  • 옵션

    NotifyOptions

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

unmount()

프로미스 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

주어진 fileSystemId를 사용하여 파일 시스템을 마운트 해제합니다. onUnmountRequested가 호출된 후에 호출해야 합니다. 또한 확장 프로그램이 요청하지 않으면 마운트 해제를 수행할 수 있습니다 (예: 연결이 끊어지거나 파일 오류가 발생한 경우).

오류가 발생하면 runtime.lastError가 해당 오류 코드와 함께 설정됩니다.

매개변수

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

operationRequestId로 작업을 취소하도록 요청하면 발생합니다. operationRequestId로 실행된 작업은 즉시 중지되어야 하고 이 취소 요청의 successCallback가 실행되어야 합니다. 취소에 실패하면 errorCallback를 호출해야 합니다. 취소된 작업의 콜백은 무시되므로 호출해서는 안 됩니다. errorCallback를 호출하더라도 요청이 강제로 취소될 수 있습니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: AbortRequestedOptions,successCallback: function,errorCallback: function)=>void

    • successCallback

      기능

      successCallback 매개변수는 다음과 같습니다. 

      ()=>void

    • errorCallback

      기능

      errorCallback 매개변수는 다음과 같습니다. 

      (error: ProviderError)=>void

onAddWatcherRequested

Chrome 45 이상 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

새 디렉터리 감시자 설정이 요청되면 발생합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: AddWatcherRequestedOptions,successCallback: function,errorCallback: function)=>void

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

이전에 openRequestId로 열었던 파일을 닫도록 요청하면 발생합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: CloseFileRequestedOptions,successCallback: function,errorCallback: function)=>void

onConfigureRequested

Chrome 44 이상 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

fileSystemId가 요청된 구성 대화상자를 표시하면 발생합니다. 처리되는 경우 file_system_provider.configurable manfiest 옵션을 true로 설정해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: ConfigureRequestedOptions,successCallback: function,errorCallback: function)=>void

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

디렉터리인 경우 재귀적으로 항목 복사가 요청되면 발생합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: CopyEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

디렉터리 생성이 요청되면 발생합니다. 대상 디렉터리가 이미 존재하는 경우 작업이 EXISTS 오류와 함께 실패해야 합니다. recursive이 true이면 디렉터리 경로에서 누락된 디렉터리를 모두 만들어야 합니다.

매개변수

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

파일 생성이 요청되면 발생합니다. 파일이 이미 있으면 "EXISTS" 오류 코드와 함께 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: CreateFileRequestedOptions,successCallback: function,errorCallback: function)=>void

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

항목 삭제를 요청하면 발생합니다. recursive이 true이고 항목이 디렉터리인 경우 내부의 모든 항목도 재귀적으로 삭제해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: DeleteEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onExecuteActionRequested

Chrome 48 이상 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

파일 또는 디렉터리 집합에 대한 작업을 실행하면 발생합니다. 작업이 완료되면 successCallback를 호출해야 합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

onGetActionsRequested

Chrome 48 이상 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

entryPaths에 있는 파일 또는 디렉터리 집합의 작업 목록이 요청되면 발생합니다. 반환된 모든 작업은 각 항목에 적용할 수 있어야 합니다. 이러한 작업이 없으면 빈 배열을 반환해야 합니다. 작업은 successCallback 호출과 함께 반환되어야 합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

entryPath에 있는 파일 또는 디렉터리의 메타데이터가 요청되면 발생합니다. 메타데이터는 successCallback 호출과 함께 반환되어야 합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

onMountRequested

Chrome 44 이상 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

새 파일 시스템 마운트가 요청되었다는 대화상자를 표시하면 발생합니다. 확장 프로그램/앱이 파일 핸들러인 경우 이 이벤트를 처리하면 안 됩니다. 대신 파일을 열 때 새 파일 시스템을 마운트하려면 app.runtime.onLaunched를 처리해야 합니다. 여러 마운트의 경우 file_system_provider.multiple_mounts 매니페스트 옵션을 true로 설정해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (successCallback: function,errorCallback: function)=>void

    • successCallback

      기능

      successCallback 매개변수는 다음과 같습니다. 

      ()=>void

    • errorCallback

      기능

      errorCallback 매개변수는 다음과 같습니다. 

      (error: ProviderError)=>void

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

디렉터리인 경우 재귀적으로 항목 이동이 요청되면 발생합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: MoveEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

filePath에서 파일을 열도록 요청되면 발생합니다. 파일이 없으면 작업은 실패해야 합니다. 한 번에 열리는 최대 파일 수는 MountOptions로 지정할 수 있습니다.

매개변수

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

directoryPath에 있는 디렉터리의 콘텐츠가 요청되면 발생합니다. successCallback를 여러 번 호출하여 결과를 단위별로 반환해야 합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

이전에 openRequestId로 연 파일의 콘텐츠 읽기를 요청하면 발생합니다. successCallback를 여러 번 호출하여 결과를 단위별로 반환해야 합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: ReadFileRequestedOptions,successCallback: function,errorCallback: function)=>void

    • successCallback

      기능

      successCallback 매개변수는 다음과 같습니다. 

      (data: ArrayBuffer,hasMore: boolean)=>void

      • 데이터

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      기능

      errorCallback 매개변수는 다음과 같습니다. 

      (error: ProviderError)=>void

onRemoveWatcherRequested

Chrome 45 이상 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

감시자를 삭제해야 할 때 발생합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

파일을 원하는 길이로 자르는 요청이 요청되면 발생합니다. 오류가 발생하면 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: TruncateRequestedOptions,successCallback: function,errorCallback: function)=>void

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

fileSystemId 식별자로 파일 시스템의 마운트 해제가 요청되면 발생합니다. 응답에서 unmount API 메서드는 successCallback와 함께 호출되어야 합니다. 대기 중인 작업 등으로 인해 마운트 해제가 불가능한 경우에는 errorCallback를 호출해야 합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: UnmountRequestedOptions,successCallback: function,errorCallback: function)=>void

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

이전에 openRequestId로 연 파일에 콘텐츠를 쓸 때 발생합니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (options: WriteFileRequestedOptions,successCallback: function,errorCallback: function)=>void