chrome.fileSystemProvider

설명

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

권한

fileSystemProvider

가용성

<ph type="x-smartling-placeholder"></ph> ChromeOS만 해당 를 통해 개인정보처리방침을 정의할 수 있습니다.

매니페스트

'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 (불리언) - 선택사항
여러 개 (둘 이상)의 마운트된 파일 시스템 지원 여부입니다. 기본값은 false입니다.
watchable (불리언) - 선택사항
감시자 설정 및 변경사항 알림 지원 여부입니다. 기본값은 false입니다.
source('파일', '기기' 또는 '네트워크'의 열거형) - 필수
마운트된 파일 시스템의 데이터 소스입니다.

Files 앱은 관련 UI 요소를 적절하게 렌더링하기 위해 위의 정보를 사용합니다. 예를 들어 configurable를 true로 설정하면 볼륨 구성을 위한 메뉴 항목이 렌더링됩니다. 마찬가지로 multiple_mounts가 true로 설정되면 Files 앱은 UI에서 마운트 지점을 2개 이상 추가할 수 있습니다. 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

    부울

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

  • requestId

    숫자

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

Change

속성

  • changeType

    ChangeType

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

  • cloudFileInfo

    CloudFileInfo 선택사항

    Chrome 125 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

  • entryPath

    문자열

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

ChangeType

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

열거형

"변경됨"

'삭제됨'

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'

&quot;OFFLINE_NOT_NECESSARY&quot;

"공유"

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에서 요청된 경우 제공해야 합니다.

  • 크기

    숫자 선택사항

    파일 크기(바이트)입니다. options에서 요청된 경우 제공해야 합니다.

  • 썸네일

    문자열(선택사항)

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

ExecuteActionRequestedOptions

Chrome 45 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

  • actionId

    문자열

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

  • entryPaths

    문자열[]

    Chrome 47 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

  • fileSystemId

    문자열

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

  • requestId

    숫자

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

FileSystemInfo

속성

  • displayName

    문자열

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

  • fileSystemId

    문자열

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

  • openedFiles

    OpenedFile[]

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

  • openedFilesLimit

    숫자

    한 번에 열 수 있는 최대 파일 수입니다. 0이면 제한이 없습니다.

  • supportsNotifyTag

    불리언 선택사항

    Chrome 45 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

  • 시청자

    감시자[]

    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

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

  • 변경사항

    변경[] 선택사항

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

  • fileSystemId

    문자열

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

  • observedPath

    문자열

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

  • recursive

    부울

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

  • 태그

    문자열(선택사항)

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

OpenedFile

속성

  • filePath

    문자열

    열린 파일의 경로입니다.

  • 모드

    OpenFileMode

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

  • openRequestId

    숫자

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

OpenFileMode

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

열거형

"읽기"

'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'

"보안"

'취소'

'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

    부울

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

WriteFileRequestedOptions

속성

  • 데이터

    배열 버퍼

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

  • fileSystemId

    문자열

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

  • 오프셋

    숫자

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

  • openRequestId

    숫자

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

  • requestId

    숫자

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

메서드

get()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

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

매개변수

  • fileSystemId

    문자열

  • 콜백

    함수 선택사항

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

    (fileSystem: FileSystemInfo) => void

반환 값

  • Promise&lt;FileSystemInfo&gt;

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getAll()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.getAll(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    (fileSystems: FileSystemInfo[]) => void

반환 값

  • Promise&lt;FileSystemInfo[]&gt;

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

mount()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

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

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

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

매개변수

  • 옵션

    MountOptions

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

notify()

<ph type="x-smartling-placeholder"></ph> 프로미스 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

반환 값

  • 프로미스<void>

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

unmount()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

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

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

매개변수

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onCopyEntryRequested

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

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

매개변수

  • 콜백

    함수

    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 매개변수는 다음과 같습니다. 

    (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를 호출해야 합니다.

매개변수

  • 콜백

    함수

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

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

onGetActionsRequested

Chrome 48 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

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

매개변수

  • 콜백

    함수

    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 매개변수는 다음과 같습니다. 

    (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

    • 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 매개변수는 다음과 같습니다. 

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

    • successCallback

      함수

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

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

      • 데이터

        배열 버퍼

      • hasMore

        부울

    • errorCallback

      함수

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

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

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

매개변수

  • 콜백

    함수

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

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

onTruncateRequested

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

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

매개변수

  • 콜백

    함수

    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 매개변수는 다음과 같습니다. 

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void

onWriteFileRequested

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

이전에 openRequestId를 사용하여 연 파일에 콘텐츠를 쓸 때 발생합니다.

매개변수

  • 콜백

    함수

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

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

    • successCallback

      함수

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

      () => void

    • errorCallback

      함수

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

      (error: ProviderError) => void