설명
chrome.fileSystemProvider
API를 사용하여 파일 시스템을 만들 수 있습니다. 파일 시스템은 Chrome OS의 파일 관리자에서 액세스할 수 있습니다.
권한
fileSystemProvider
가용성
매니페스트
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
속성
-
id
문자열
작업의 식별자입니다. 임의의 문자열 또는
CommonActionId
(일반적인 작업의 경우) -
title
문자열 선택사항
작업의 제목입니다. 일반적인 작업에서는 무시될 수 있습니다.
AddWatcherRequestedOptions
속성
-
entryPath
문자열
관찰할 항목의 경로입니다.
-
fileSystemId
문자열
이 작업과 관련된 파일 시스템의 식별자입니다.
-
recursive
boolean
관찰에 모든 하위 항목이 재귀적으로 포함되어야 하는지 여부입니다. 디렉터리에만 적용될 수 있습니다.
-
requestId
숫자
이 요청의 고유 식별자입니다.
Change
속성
-
changeType
항목에 발생한 변경 유형입니다.
-
cloudFileInfo
CloudFileInfo 선택사항
Chrome 125 이상클라우드 파일 시스템에서 지원하는 경우 파일과 관련된 정보입니다.
-
entryPath
문자열
변경된 항목의 경로입니다.
ChangeType
관찰된 디렉터리에서 감지된 변경사항의 유형입니다.
enum
CloseFileRequestedOptions
속성
-
fileSystemId
문자열
이 작업과 관련된 파일 시스템의 식별자입니다.
-
openRequestId
숫자
파일을 여는 데 사용되는 요청 ID입니다.
-
requestId
숫자
이 요청의 고유 식별자입니다.
CloudFileInfo
속성
-
versionTag
문자열 선택사항
파일의 버전을 나타내는 태그.
CloudIdentifier
속성
-
id
문자열
지정된 파일/디렉터리의 제공자 식별자입니다.
-
providerName
문자열
클라우드 저장소 제공업체의 식별자입니다 (예: 'drive.google.com').
CommonActionId
일반적인 작업 목록입니다. "SHARE"
에서는 다른 사람과 파일을 공유할 수 있습니다. 고정을 위한 "SAVE_FOR_OFFLINE"
(오프라인 액세스를 위해 저장) "OFFLINE_NOT_NECESSARY"
: 오프라인 액세스를 위해 더 이상 파일을 저장할 필요가 없음을 알리는 데 사용됩니다. onGetActionsRequested
및 onExecuteActionRequested
에서 사용됩니다.
enum
ConfigureRequestedOptions
속성
-
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 선택사항
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
속성
-
actionId
문자열
실행할 작업의 식별자입니다.
-
entryPaths
문자열[]
Chrome 47 이상작업에 사용할 항목의 경로 집합입니다.
-
fileSystemId
문자열
이 작업과 관련된 파일 시스템의 식별자입니다.
-
requestId
숫자
이 요청의 고유 식별자입니다.
FileSystemInfo
속성
-
displayName
문자열
사람이 읽을 수 있는 파일 시스템 이름입니다.
-
fileSystemId
문자열
파일 시스템의 식별자입니다.
-
openedFiles
현재 열려 있는 파일 목록입니다.
-
openedFilesLimit
숫자
한 번에 열 수 있는 최대 파일 수입니다. 0인 경우 제한이 적용되지 않습니다.
-
supportsNotifyTag
부울 선택사항
Chrome 45 이상파일 시스템이 디렉터리 관찰을 위한
tag
필드를 지원하는지 여부입니다. -
감시자
감시자[]
Chrome 45 이상감시자 목록입니다.
-
쓰기 가능
boolean
파일 시스템이 파일 시스템의 콘텐츠를 변경할 수 있는 작업 (예: 파일 만들기, 삭제, 쓰기)을 지원하는지 여부입니다.
GetActionsRequestedOptions
속성
-
entryPaths
문자열[]
Chrome 47 이상작업 목록의 항목 경로 목록입니다.
-
fileSystemId
문자열
이 작업과 관련된 파일 시스템의 식별자입니다.
-
requestId
숫자
이 요청의 고유 식별자입니다.
GetMetadataRequestedOptions
속성
-
cloudFileInfo
boolean
Chrome 125 이상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
관찰된 항목에 발생한 변경 유형입니다. 삭제된 경우 관찰된 항목이 관찰된 항목 목록에서 자동으로 삭제됩니다.
-
변경사항
변경[] 선택사항
관찰된 디렉터리 내의 항목 변경사항 목록 (항목 자체 포함)
-
fileSystemId
문자열
이 변경사항과 관련된 파일 시스템의 식별자입니다.
-
observedPath
문자열
관찰된 항목의 경로입니다.
-
recursive
boolean
관찰된 항목의 모드입니다.
-
태그
문자열 선택사항
알림에 대한 태그입니다. 파일 시스템이
supportsNotifyTag
옵션으로 마운트된 경우 필수입니다. 참고로, 이 플래그는 시스템이 종료되었을 때도 변경된 사항에 대한 알림을 제공하는 데 필요합니다.
OpenedFile
속성
-
filePath
문자열
열린 파일의 경로입니다.
-
모드
파일이 읽기 또는 쓰기를 위해 열렸는지 여부입니다.
-
openRequestId
숫자
연속 읽기/쓰기 및 닫기 요청에 사용할 요청 ID입니다.
OpenFileMode
파일을 여는 모드입니다. onOpenFileRequested
에서 사용됩니다.
enum
OpenFileRequestedOptions
속성
-
filePath
문자열
열 파일의 경로입니다.
-
fileSystemId
문자열
이 작업과 관련된 파일 시스템의 식별자입니다.
-
모드
파일을 읽기 또는 쓰기에 사용할지 여부입니다.
-
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
-
fileSystem
-
반환 값
-
Promise<FileSystemInfo>
Chrome 96 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
getAll()
chrome.fileSystemProvider.getAll(
callback?: function,
)
확장 프로그램에 의해 마운트된 모든 파일 시스템을 반환합니다.
매개변수
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.(fileSystems: FileSystemInfo[]) => void
-
fileSystems
-
반환 값
-
Promise<FileSystemInfo[]>
Chrome 96 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
mount()
chrome.fileSystemProvider.mount(
options: MountOptions,
callback?: function,
)
지정된 fileSystemId
및 displayName
로 파일 시스템을 마운트합니다. 파일 앱의 왼쪽 패널에 displayName
이(가) 표시됩니다. displayName
에는 '/'를 포함한 모든 문자가 포함될 수 있지만 빈 문자열을 입력할 수는 없습니다. displayName
은 설명적이어야 하지만 고유하지 않아도 됩니다. fileSystemId
은(는) 빈 문자열이 아니어야 합니다.
마운트되는 파일 시스템의 유형에 따라 source
옵션을 적절하게 설정해야 합니다.
오류가 발생하면 runtime.lastError
가 해당 오류 코드와 함께 설정됩니다.
매개변수
-
옵션
-
콜백
함수 선택사항
callback
매개변수는 다음과 같습니다.() => void
반환 값
-
Promise<void>
Chrome 96 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
notify()
chrome.fileSystemProvider.notify(
options: NotifyOptions,
callback?: function,
)
recursive
모드에서 observedPath
에 있는 감시된 디렉터리의 변경사항을 알립니다. 파일 시스템이 supportsNotifyTag
로 마운트된 경우 tag
를 제공해야 하며 시스템이 종료된 경우에도 마지막 알림 이후의 모든 변경사항이 항상 보고되어야 합니다. 마지막 태그는 getAll
로 가져올 수 있습니다.
사용하려면 file_system_provider.notify
매니페스트 옵션을 true로 설정해야 합니다.
tag
값은 호출별로 고유한 모든 문자열이 될 수 있으므로 마지막으로 등록된 알림을 식별할 수 있습니다. 예를 들어 확장 프로그램 제공이 재부팅 후 시작되고 마지막으로 등록된 알림의 태그가 '123'인 경우 변경사항에 '123'으로 태그된 이후 발생한 모든 변경사항에 대해 notify
를 호출해야 합니다. 빈 문자열일 수 없습니다.
일부 제공자가 태그를 제공할 수 있는 것은 아니지만 파일 시스템에 변경 로그가 있는 경우 태그는 변경 번호나 버전 번호 등이 될 수 있습니다.
상위 디렉터리가 삭제되면 모든 하위 항목도 삭제되며, 감시할 경우 API에 이 사실을 알려야 합니다. 또한 디렉터리의 이름이 바뀌면 원래 경로 아래에 항목이 더 이상 없으므로 모든 하위 항목이 실제로 삭제됩니다.
오류가 발생하면 runtime.lastError
가 해당 오류 코드로 설정됩니다.
매개변수
-
콜백
함수 선택사항
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
-
error
-
onAddWatcherRequested
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
callback: function,
)
새 디렉터리 감시자 설정이 요청되면 발생합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onCloseFileRequested
chrome.fileSystemProvider.onCloseFileRequested.addListener(
callback: function,
)
이전에 openRequestId
로 열었던 파일을 닫도록 요청하면 발생합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onConfigureRequested
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
-
error
-
onCopyEntryRequested
chrome.fileSystemProvider.onCopyEntryRequested.addListener(
callback: function,
)
디렉터리인 경우 재귀적으로 항목 복사가 요청되면 발생합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onCreateDirectoryRequested
chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
callback: function,
)
디렉터리 생성이 요청되면 발생합니다. 대상 디렉터리가 이미 존재하는 경우 작업이 EXISTS 오류와 함께 실패해야 합니다. recursive
이 true이면 디렉터리 경로에서 누락된 디렉터리를 모두 만들어야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onCreateFileRequested
chrome.fileSystemProvider.onCreateFileRequested.addListener(
callback: function,
)
파일 생성이 요청되면 발생합니다. 파일이 이미 있으면 "EXISTS"
오류 코드와 함께 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onDeleteEntryRequested
chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
callback: function,
)
항목 삭제를 요청하면 발생합니다. recursive
이 true이고 항목이 디렉터리인 경우 내부의 모든 항목도 재귀적으로 삭제해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onExecuteActionRequested
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
callback: function,
)
파일 또는 디렉터리 집합에 대한 작업을 실행하면 발생합니다. 작업이 완료되면 successCallback
를 호출해야 합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onGetActionsRequested
chrome.fileSystemProvider.onGetActionsRequested.addListener(
callback: function,
)
entryPaths
에 있는 파일 또는 디렉터리 집합의 작업 목록이 요청되면 발생합니다. 반환된 모든 작업은 각 항목에 적용할 수 있어야 합니다. 이러한 작업이 없으면 빈 배열을 반환해야 합니다. 작업은 successCallback
호출과 함께 반환되어야 합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.(actions: Action[]) => void
-
작업
조치[]
-
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onGetMetadataRequested
chrome.fileSystemProvider.onGetMetadataRequested.addListener(
callback: function,
)
entryPath
에 있는 파일 또는 디렉터리의 메타데이터가 요청되면 발생합니다. 메타데이터는 successCallback
호출과 함께 반환되어야 합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.(metadata: EntryMetadata) => void
-
metadata
-
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onMountRequested
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
-
error
-
-
onMoveEntryRequested
chrome.fileSystemProvider.onMoveEntryRequested.addListener(
callback: function,
)
디렉터리인 경우 재귀적으로 항목 이동이 요청되면 발생합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onOpenFileRequested
chrome.fileSystemProvider.onOpenFileRequested.addListener(
callback: function,
)
filePath
에서 파일을 열도록 요청되면 발생합니다. 파일이 없으면 작업은 실패해야 합니다. 한 번에 열리는 최대 파일 수는 MountOptions
로 지정할 수 있습니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.(metadata?: EntryMetadata) => void
-
metadata
EntryMetadata 선택사항
-
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onReadDirectoryRequested
chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
callback: function,
)
directoryPath
에 있는 디렉터리의 콘텐츠가 요청되면 발생합니다. successCallback
를 여러 번 호출하여 결과를 단위별로 반환해야 합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.(entries: EntryMetadata[], hasMore: boolean) => void
-
entries
-
hasMore
boolean
-
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
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
-
error
-
onRemoveWatcherRequested
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
callback: function,
)
감시자를 삭제해야 할 때 발생합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
onTruncateRequested
chrome.fileSystemProvider.onTruncateRequested.addListener(
callback: function,
)
파일을 원하는 길이로 자르는 요청이 요청되면 발생합니다. 오류가 발생하면 errorCallback
를 호출해야 합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-
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
-
error
-
onWriteFileRequested
chrome.fileSystemProvider.onWriteFileRequested.addListener(
callback: function,
)
이전에 openRequestId
로 연 파일에 콘텐츠를 쓸 때 발생합니다.
매개변수
-
콜백
기능
callback
매개변수는 다음과 같습니다.(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
기능
successCallback
매개변수는 다음과 같습니다.() => void
-
errorCallback
기능
errorCallback
매개변수는 다음과 같습니다.(error: ProviderError) => void
-
error
-