chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

설명

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

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

개요

File System Provider 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 이상

    이 항목의 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 필드를 지원하는지 여부입니다.

  • watchers

    감시자[]

    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

    number 선택사항

    한 번에 열 수 있는 최대 파일 수입니다. 지정하지 않거나 0으로 설정하면 제한이 없습니다.

  • 영구

    불리언 선택사항

    Chrome 64 이상

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

  • supportsNotifyTag

    불리언 선택사항

    Chrome 45 이상

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

  • 쓰기 가능

    불리언 선택사항

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

MoveEntryRequestedOptions

속성

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

  • sourcePath

    문자열

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

  • targetPath

    문자열

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

NotifyOptions

속성

  • changeType

    ChangeType

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

  • 변경사항

    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"

'보안'

"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()

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

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

매개변수

  • fileSystemId

    문자열

  • callback

    함수 선택사항

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

    (fileSystem: FileSystemInfo) => void

반환 값

  • Promise<FileSystemInfo>

    Chrome 96 이상

    get 함수의 결과를 수신하는 콜백입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getAll()

Promise 
chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

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

매개변수

  • callback

    함수 선택사항

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

    (fileSystems: FileSystemInfo[]) => void

반환 값

  • Promise<FileSystemInfo[]>

    Chrome 96 이상

    getAll 함수의 결과를 수신하는 콜백입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

mount()

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

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

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

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

매개변수

  • 옵션

    MountOptions

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    Chrome 96 이상

    성공 또는 실패를 나타내는 일반 결과 콜백입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

notify()

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

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

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

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

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

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

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

매개변수

  • 옵션

    NotifyOptions

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    Chrome 96 이상

    성공 또는 실패를 나타내는 일반 결과 콜백입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

unmount()

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

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

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

매개변수

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    Chrome 96 이상

    성공 또는 실패를 나타내는 일반 결과 콜백입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

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