chrome.fileSystemProvider

설명

chrome.fileSystemProvider API를 사용하여 ChromeOS의 파일 관리자에서 액세스할 수 있는 파일 시스템을 만듭니다.

권한

fileSystemProvider

가용성

ChromeOS만 해당

파일 시스템 제공자 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' 열거형) - 필수
마운트된 파일 시스템의 데이터 소스입니다.

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

개요

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

파일 시스템 마운트

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

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

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

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

파일 시스템 구성

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

수명 주기

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

유형

AbortRequestedOptions

속성

  • fileSystemId

    문자열

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

  • operationRequestId

    숫자

    중단할 요청의 ID입니다.

  • requestId

    숫자

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

Action

Chrome 45 이상

속성

  • id

    문자열

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

  • 제목

    문자열 선택사항

    작업의 제목입니다. 일반적인 작업의 경우 무시될 수 있습니다.

AddWatcherRequestedOptions

속성

  • entryPath

    문자열

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

  • fileSystemId

    문자열

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

  • recursive

    부울

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

  • requestId

    숫자

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

Change

속성

  • changeType

    ChangeType

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

  • cloudFileInfo

    CloudFileInfo 선택사항

    Chrome 125 이상

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

  • entryPath

    문자열

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

ChangeType

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

열거형

'CHANGED'

"DELETED"

CloseFileRequestedOptions

속성

  • fileSystemId

    문자열

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

  • openRequestId

    숫자

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

  • requestId

    숫자

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

CloudFileInfo

Chrome 125 이상

속성

  • versionTag

    문자열 선택사항

    파일 버전을 나타내는 태그입니다.

CloudIdentifier

Chrome 117 이상

속성

  • id

    문자열

    지정된 파일/디렉터리에 대한 공급자의 식별자입니다.

  • providerName

    문자열

    클라우드 스토리지 제공업체의 식별자입니다 (예: 'drive.google.com').

CommonActionId

Chrome 45 이상

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

열거형

'SAVE_FOR_OFFLINE'

"OFFLINE_NOT_NECESSARY"

'공유'

ConfigureRequestedOptions

Chrome 44 이상

속성

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

CopyEntryRequestedOptions

속성

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

  • sourcePath

    문자열

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

  • targetPath

    문자열

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

CreateDirectoryRequestedOptions

속성

  • directoryPath

    문자열

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

  • fileSystemId

    문자열

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

  • recursive

    부울

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

  • requestId

    숫자

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

CreateFileRequestedOptions

속성

  • filePath

    문자열

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

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

DeleteEntryRequestedOptions

속성

  • entryPath

    문자열

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

  • fileSystemId

    문자열

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

  • recursive

    부울

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

  • requestId

    숫자

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

EntryMetadata

속성

  • cloudFileInfo

    CloudFileInfo 선택사항

    Chrome 125 이상

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

  • cloudIdentifier

    CloudIdentifier 선택사항

    Chrome 117 이상

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

  • isDirectory

    불리언 선택사항

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

  • mimeType

    문자열 선택사항

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

  • modificationTime

    날짜 선택사항

    이 항목의 마지막 수정 시간입니다. options에서 요청된 경우 제공해야 합니다.

  • 이름

    문자열 선택사항

    이 항목의 이름입니다 (전체 경로 이름 아님). '/'를 포함할 수 없습니다. 루트의 경우 비워야 합니다. options에서 요청된 경우 제공해야 합니다.

  • 크기

    번호 선택사항

    파일 크기(바이트)입니다. 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 필드를 지원하는지 여부입니다.

  • 감시자

    Watcher[]

    Chrome 45 이상

    감시자 목록입니다.

  • 쓰기 가능

    부울

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

GetActionsRequestedOptions

Chrome 45 이상

속성

  • entryPaths

    문자열[]

    Chrome 47 이상

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

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

GetMetadataRequestedOptions

속성

  • cloudFileInfo

    부울

    Chrome 125 이상

    cloudFileInfo 값이 요청된 경우 true로 설정됩니다.

  • cloudIdentifier

    부울

    Chrome 117 이상

    cloudIdentifier 값이 요청된 경우 true로 설정됩니다.

  • entryPath

    문자열

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

  • fileSystemId

    문자열

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

  • isDirectory

    부울

    Chrome 49 이상

    is_directory 값이 요청된 경우 true로 설정됩니다.

  • mimeType

    부울

    Chrome 49 이상

    mimeType 값이 요청된 경우 true로 설정됩니다.

  • modificationTime

    부울

    Chrome 49 이상

    modificationTime 값이 요청된 경우 true로 설정됩니다.

  • 이름

    부울

    Chrome 49 이상

    name 값이 요청된 경우 true로 설정됩니다.

  • requestId

    숫자

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

  • 크기

    부울

    Chrome 49 이상

    size 값이 요청된 경우 true로 설정됩니다.

  • 썸네일

    부울

    thumbnail 값이 요청된 경우 true로 설정됩니다.

MountOptions

속성

  • displayName

    문자열

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

  • fileSystemId

    문자열

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

  • openedFilesLimit

    번호 선택사항

    한 번에 열 수 있는 최대 파일 수입니다. 지정하지 않거나 0인 경우 제한이 없습니다.

  • 영구

    불리언 선택사항

    Chrome 64 이상

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

  • supportsNotifyTag

    불리언 선택사항

    Chrome 45 이상

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

  • 쓰기 가능

    불리언 선택사항

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

MoveEntryRequestedOptions

속성

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

  • sourcePath

    문자열

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

  • targetPath

    문자열

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

NotifyOptions

속성

  • changeType

    ChangeType

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

  • 변경사항

    Change[] 선택사항

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

  • fileSystemId

    문자열

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

  • observedPath

    문자열

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

  • recursive

    부울

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

  • 태그

    문자열 선택사항

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

OpenedFile

속성

  • filePath

    문자열

    열린 파일의 경로입니다.

  • 모드

    OpenFileMode

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

  • openRequestId

    숫자

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

OpenFileMode

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

열거형

'READ'

'WRITE'

OpenFileRequestedOptions

속성

  • filePath

    문자열

    열 파일의 경로입니다.

  • fileSystemId

    문자열

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

  • 모드

    OpenFileMode

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

  • requestId

    숫자

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

ProviderError

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

열거형

"확인"

'FAILED'

"IN_USE"

"EXISTS"

'NOT_FOUND'

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

'NOT_A_FILE'

"NOT_EMPTY"

'INVALID_URL'

"IO"

ReadDirectoryRequestedOptions

속성

  • directoryPath

    문자열

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

  • fileSystemId

    문자열

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

  • isDirectory

    부울

    Chrome 49 이상

    is_directory 값이 요청된 경우 true로 설정됩니다.

  • mimeType

    부울

    Chrome 49 이상

    mimeType 값이 요청된 경우 true로 설정됩니다.

  • modificationTime

    부울

    Chrome 49 이상

    modificationTime 값이 요청된 경우 true로 설정됩니다.

  • 이름

    부울

    Chrome 49 이상

    name 값이 요청된 경우 true로 설정됩니다.

  • requestId

    숫자

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

  • 크기

    부울

    Chrome 49 이상

    size 값이 요청된 경우 true로 설정됩니다.

  • 썸네일

    부울

    Chrome 49 이상

    thumbnail 값이 요청된 경우 true로 설정됩니다.

ReadFileRequestedOptions

속성

  • fileSystemId

    문자열

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

  • 길이

    숫자

    반환할 바이트 수입니다.

  • 오프셋

    숫자

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

  • openRequestId

    숫자

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

  • requestId

    숫자

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

RemoveWatcherRequestedOptions

속성

  • entryPath

    문자열

    감시 항목의 경로입니다.

  • fileSystemId

    문자열

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

  • recursive

    부울

    감시자 모드입니다.

  • requestId

    숫자

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

TruncateRequestedOptions

속성

  • filePath

    문자열

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

  • fileSystemId

    문자열

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

  • 길이

    숫자

    작업이 완료된 후 유지할 바이트 수입니다.

  • requestId

    숫자

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

UnmountOptions

속성

  • fileSystemId

    문자열

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

UnmountRequestedOptions

속성

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

Watcher

속성

  • entryPath

    문자열

    관찰 중인 항목의 경로입니다.

  • lastTag

    문자열 선택사항

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

  • recursive

    부울

    감시에 모든 하위 항목을 재귀적으로 포함해야 하는지 여부입니다. 디렉터리에 대해서만 참일 수 있습니다.

WriteFileRequestedOptions

속성

  • 데이터

    ArrayBuffer

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

  • fileSystemId

    문자열

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

  • 오프셋

    숫자

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

  • openRequestId

    숫자

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

  • requestId

    숫자

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

메서드

get()

chrome.fileSystemProvider.get(
  fileSystemId: string,
): Promise<FileSystemInfo>

전달된 fileSystemId를 사용하여 파일 시스템에 관한 정보를 반환합니다.

매개변수

  • fileSystemId

    문자열

반환 값

getAll()

chrome.fileSystemProvider.getAll(): Promise<FileSystemInfo[]>

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

반환 값

mount()

chrome.fileSystemProvider.mount(
  options: MountOptions,
): Promise<void>

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

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

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

매개변수

반환 값

  • Promise<void>

    Chrome 96 이상

notify()

Chrome 45 이상 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
): Promise<void>

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

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

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

모든 제공업체가 태그를 제공할 수 있는 것은 아니지만 파일 시스템에 변경사항 로그가 있는 경우 태그는 변경 번호나 수정 번호일 수 있습니다.

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

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

매개변수

반환 값

  • Promise<void>

    Chrome 96 이상

unmount()

chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
): Promise<void>

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

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

매개변수

반환 값

  • Promise<void>

    Chrome 96 이상

이벤트

onAbortRequested

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

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

매개변수

  • callback

    함수

    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

    함수

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

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

onCloseFileRequested

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

이전에 openRequestId로 열린 파일을 닫도록 요청할 때 발생합니다.

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onConfigureRequested

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

fileSystemId의 구성 대화상자를 표시하도록 요청된 경우 발생합니다. 처리된 경우 file_system_provider.configurable 매니페스트 옵션을 true로 설정해야 합니다.

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onCopyEntryRequested

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

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

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onCreateDirectoryRequested

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

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

매개변수

onCreateFileRequested

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

파일 생성이 요청될 때 발생합니다. 파일이 이미 있는 경우 "EXISTS" 오류 코드로 errorCallback를 호출해야 합니다.

매개변수

  • callback

    함수

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

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

onDeleteEntryRequested

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

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

매개변수

  • callback

    함수

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

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

onExecuteActionRequested

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

파일 또는 디렉터리 집합에 대한 작업을 실행하도록 요청될 때 발생합니다. 작업이 완료된 후 successCallback을 호출해야 합니다. 오류 발생 시 errorCallback을 호출해야 합니다.

매개변수

  • callback

    함수

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

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

onGetActionsRequested

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

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

매개변수

  • callback

    함수

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

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

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

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onMoveEntryRequested

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

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

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => 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

    함수

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

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

    • successCallback

      함수

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

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

      • 데이터

        ArrayBuffer

      • hasMore

        부울

    • errorCallback

      함수

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

      (error: ProviderError) => void

onRemoveWatcherRequested

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

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

매개변수

  • callback

    함수

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

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

onTruncateRequested

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

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

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onUnmountRequested

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

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

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onWriteFileRequested

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

이전에 openRequestId로 열린 파일에 콘텐츠를 쓰도록 요청될 때 발생합니다.

매개변수

  • callback

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void