Deskripsi
Gunakan chrome.fileSystemProvider
API untuk membuat sistem file yang dapat diakses dari pengelola file di Chrome OS.
Izin
fileSystemProvider
Ketersediaan
Anda harus menyatakan bagian izin dan izin "fileSystemProvider" di manifes ekstensi untuk menggunakan File System Provider API. Contoh:
{
"name": "My extension",
...
"permissions": [
"fileSystemProvider"
],
...
"file_system_provider_capabilities": {
"configurable": true,
"watchable": false,
"multiple_mounts": true,
"source": "network"
},
...
}
Bagian file_system_provider harus dideklarasikan sebagai berikut:
configurable
(boolean) - opsional- Apakah konfigurasi melalui onConfigureRequest didukung. Secara default: false.
multiple_mounts
(boolean) - opsional- Apakah beberapa (lebih dari satu) sistem file yang terpasang didukung. Secara default: false.
watchable
(boolean) - opsional- Apakah menyetel pengamat dan memberi tahu perubahan didukung atau tidak. Secara default: false.
source
(enum "file", "perangkat", atau "jaringan") - wajib ada- Sumber data untuk sistem file yang terpasang.
Aplikasi Files menggunakan informasi di atas untuk merender elemen UI terkait dengan tepat. Misalnya, jika configurable
disetel ke benar (true), item menu untuk mengonfigurasi volume akan dirender. Demikian pula, jika multiple_mounts
disetel ke true
, aplikasi File akan mengizinkan penambahan lebih dari satu titik pemasangan dari UI. Jika watchable
adalah false
, tombol muat ulang akan dirender. Perhatikan bahwa jika memungkinkan, Anda harus menambahkan dukungan untuk watcher, sehingga perubahan pada sistem file dapat langsung dan otomatis diterapkan.
Ringkasan
File System Provider API memungkinkan ekstensi untuk mendukung sistem file virtual, yang tersedia di file manager di ChromeOS. Kasus penggunaan mencakup dekompresi arsip dan mengakses file di layanan cloud selain Drive.
Memasang sistem file
Menyediakan ekstensi bisa berupa konten sistem file dari sumber eksternal (seperti server jarak jauh atau perangkat USB), atau menggunakan file lokal (seperti arsip) sebagai inputnya.
Untuk menulis sistem file yang merupakan pengendali file (sumbernya adalah "file"
), penyedia harus berupa aplikasi terpaket, karena peristiwa onLaunched
tidak tersedia untuk ekstensi.
Jika sumbernya adalah jaringan atau perangkat, sistem file harus dipasang saat peristiwa onMountRequested dipanggil.
Sumber data sistem file | Titik entri |
---|---|
"file" |
Hanya tersedia untuk aplikasi terpaket. |
"device" atau "network" |
onMountRequested |
Mengonfigurasi sistem file
Sistem file yang disediakan setelah terpasang dapat dikonfigurasi melalui peristiwa onConfigureRequested. Ini sangat berguna untuk sistem file yang menyediakan konten melalui jaringan untuk mengatur kredensial yang tepat. Penanganan peristiwa ini bersifat opsional.
Siklus proses
Sistem file yang disediakan setelah dipasang akan diingat oleh Chrome dan dipasang kembali secara otomatis setelah reboot atau dimulai ulang. Oleh karena itu, setelah sistem file dipasang oleh ekstensi penyedia, sistem file akan tetap terinstal hingga ekstensi dibongkar muatannya, atau ekstensi memanggil metode pelepasan.
Jenis
AbortRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
operationRequestId
angka
ID permintaan yang akan dibatalkan.
-
requestId
angka
ID unik permintaan ini.
Action
Properti
-
id
string
ID tindakan. String apa pun atau
CommonActionId
untuk tindakan umum. -
title
string opsional
Judul tindakan. Catatan ini mungkin diabaikan untuk tindakan umum.
AddWatcherRequestedOptions
Properti
-
entryPath
string
Jalur masuk yang akan diamati.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
rekursif
boolean
Apakah pengamatan harus menyertakan semua entri turunan secara rekursif. Ini bisa berlaku hanya untuk direktori.
-
requestId
angka
ID unik permintaan ini.
Change
Properti
-
changeType
Jenis perubahan yang terjadi pada entri.
-
cloudFileInfo
CloudFileInfo opsional
Chrome 125 dan yang lebih baruInformasi yang berkaitan dengan file jika didukung oleh sistem file cloud.
-
entryPath
string
Jalur entri yang diubah.
ChangeType
Jenis perubahan yang terdeteksi pada direktori yang diamati.
Enum
CloseFileRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
openRequestId
angka
ID permintaan yang digunakan untuk membuka file.
-
requestId
angka
ID unik permintaan ini.
CloudFileInfo
Properti
-
versionTag
string opsional
Tag yang mewakili versi file.
CloudIdentifier
Properti
-
id
string
ID penyedia untuk file/direktori yang ditentukan.
-
providerName
string
ID untuk penyedia penyimpanan cloud (misalnya, 'drive.google.com').
CommonActionId
Daftar tindakan umum. "SHARE"
digunakan untuk berbagi file dengan orang lain. "SAVE_FOR_OFFLINE"
untuk penyematan (disimpan untuk akses offline). "OFFLINE_NOT_NECESSARY"
untuk memberi tahu bahwa file tidak perlu disimpan untuk akses offline lagi. Digunakan oleh onGetActionsRequested
dan onExecuteActionRequested
.
Enum
ConfigureRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang akan dikonfigurasi.
-
requestId
angka
ID unik permintaan ini.
CopyEntryRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
requestId
angka
ID unik permintaan ini.
-
sourcePath
string
Jalur sumber entri yang akan disalin.
-
targetPath
string
Jalur tujuan untuk operasi penyalinan.
CreateDirectoryRequestedOptions
Properti
-
directoryPath
string
Jalur direktori yang akan dibuat.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
rekursif
boolean
Apakah operasi tersebut rekursif (hanya untuk direktori).
-
requestId
angka
ID unik permintaan ini.
CreateFileRequestedOptions
Properti
-
filePath
string
Jalur file yang akan dibuat.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
requestId
angka
ID unik permintaan ini.
DeleteEntryRequestedOptions
Properti
-
entryPath
string
Jalur entri yang akan dihapus.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
rekursif
boolean
Apakah operasi tersebut rekursif (hanya untuk direktori).
-
requestId
angka
ID unik permintaan ini.
EntryMetadata
Properti
-
cloudFileInfo
CloudFileInfo opsional
Chrome 125 dan yang lebih baruInformasi yang mengidentifikasi file tertentu dalam sistem file cloud yang mendasarinya. Harus diberikan jika diminta di
options
dan file didukung oleh penyimpanan cloud. -
cloudIdentifier
CloudIdentifier opsional
Chrome 117 dan yang lebih baruRepresentasi Cloud Storage dari entri ini. Harus diberikan jika diminta di
options
dan file didukung oleh penyimpanan cloud. Untuk file lokal yang tidak didukung oleh penyimpanan cloud, seharusnya tidak ditentukan saat diminta. -
isDirectory
boolean opsional
True jika ini adalah direktori. Harus diberikan jika diminta di
options
. -
mimeType
string opsional
Jenis MIME untuk entri. Selalu opsional, tetapi harus diberikan jika diminta di
options
. -
modificationTime
Tanggal opsional
Waktu terakhir kali perubahan entri ini. Harus diberikan jika diminta di
options
. -
name
string opsional
Nama entri ini (bukan nama jalur lengkap). Tidak boleh berisi '/'. Untuk root, kolom ini harus kosong. Harus diberikan jika diminta di
options
. -
ukuran
nomor opsional
Ukuran file dalam byte. Harus diberikan jika diminta di
options
. -
gambar mini
string opsional
Gambar thumbnail sebagai URI data dalam format PNG, JPEG, atau WEBP, berukuran maksimal 32 KB. Opsional, tetapi hanya dapat diberikan jika diminta secara eksplisit oleh peristiwa
onGetMetadataRequested
.
ExecuteActionRequestedOptions
Properti
-
actionId
string
ID tindakan yang akan dieksekusi.
-
entryPaths
string[]
Chrome 47+Kumpulan jalur entri yang akan digunakan untuk tindakan.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
requestId
angka
ID unik permintaan ini.
FileSystemInfo
Properti
-
displayName
string
Nama yang dapat dibaca manusia untuk sistem file.
-
fileSystemId
string
ID sistem file.
-
openedFiles
Daftar file yang sedang dibuka.
-
openedFilesLimit
angka
Jumlah maksimum file yang dapat dibuka sekaligus. Jika 0, maka tidak dibatasi.
-
supportsNotifyTag
boolean opsional
Chrome 45+Apakah sistem file mendukung kolom
tag
untuk mengamati direktori. -
pengamat
Pengamat[]
Chrome 45+Daftar watcher.
-
dapat ditulis
boolean
Apakah sistem file mendukung operasi yang dapat mengubah konten sistem file (seperti membuat, menghapus, atau menulis ke file).
GetActionsRequestedOptions
Properti
-
entryPaths
string[]
Chrome 47+Daftar jalur entri untuk daftar tindakan.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
requestId
angka
ID unik permintaan ini.
GetMetadataRequestedOptions
Properti
-
cloudFileInfo
boolean
Chrome 125 dan yang lebih baruTetapkan ke
true
jika nilaicloudFileInfo
diminta. -
cloudIdentifier
boolean
Chrome 117 dan yang lebih baruTetapkan ke
true
jika nilaicloudIdentifier
diminta. -
entryPath
string
Jalur entri untuk mengambil metadata.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
isDirectory
boolean
Chrome 49+Tetapkan ke
true
jika nilaiis_directory
diminta. -
mimeType
boolean
Chrome 49+Tetapkan ke
true
jika nilaimimeType
diminta. -
modificationTime
boolean
Chrome 49+Tetapkan ke
true
jika nilaimodificationTime
diminta. -
name
boolean
Chrome 49+Tetapkan ke
true
jika nilainame
diminta. -
requestId
angka
ID unik permintaan ini.
-
ukuran
boolean
Chrome 49+Tetapkan ke
true
jika nilaisize
diminta. -
gambar mini
boolean
Tetapkan ke
true
jika nilaithumbnail
diminta.
MountOptions
Properti
-
displayName
string
Nama yang dapat dibaca manusia untuk sistem file.
-
fileSystemId
string
Indentifier string sistem file. Harus unik untuk setiap ekstensi.
-
openedFilesLimit
nomor opsional
Jumlah maksimum file yang dapat dibuka sekaligus. Jika tidak ditentukan, atau 0, maka tidak dibatasi.
-
persisten
boolean opsional
Chrome 64 dan yang lebih baruApakah framework harus melanjutkan sistem file pada sesi login berikutnya. Benar secara default.
-
supportsNotifyTag
boolean opsional
Chrome 45+Apakah sistem file mendukung kolom
tag
untuk direktori yang diamati. -
dapat ditulis
boolean opsional
Apakah sistem file mendukung operasi yang dapat mengubah konten sistem file (seperti membuat, menghapus, atau menulis ke file).
MoveEntryRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
requestId
angka
ID unik permintaan ini.
-
sourcePath
string
Jalur sumber entri yang akan dipindahkan ke tempat baru.
-
targetPath
string
Jalur tujuan untuk operasi penyalinan.
NotifyOptions
Properti
-
changeType
Jenis perubahan yang terjadi pada entri yang diamati. Jika DIHAPUS, maka entri yang diamati akan dihapus secara otomatis dari daftar entri yang diamati.
-
perubahan
Ubah[] opsional
Daftar perubahan pada entri dalam direktori yang diamati (termasuk entri itu sendiri)
-
fileSystemId
string
ID sistem file yang terkait dengan perubahan ini.
-
observedPath
string
Jalur entri yang diamati.
-
rekursif
boolean
Mode entri yang diamati.
-
tag
string opsional
Beri tag untuk notifikasi. Diperlukan jika sistem file dipasang dengan opsi
supportsNotifyTag
. Perhatikan bahwa flag ini diperlukan untuk memberikan notifikasi tentang perubahan yang berubah bahkan saat sistem dimatikan.
OpenedFile
Properti
-
filePath
string
Jalur file yang dibuka.
-
mode
Apakah file dibuka untuk dibaca atau ditulis.
-
openRequestId
angka
ID permintaan yang akan digunakan oleh permintaan baca/tulis dan tutup berturut-turut.
OpenFileMode
Mode membuka file. Digunakan oleh onOpenFileRequested
.
Enum
OpenFileRequestedOptions
Properti
-
filePath
string
Jalur file yang akan dibuka.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
mode
Apakah file tersebut akan digunakan untuk membaca atau menulis.
-
requestId
angka
ID permintaan yang akan digunakan oleh permintaan baca/tulis dan tutup berturut-turut.
ProviderError
Kode error yang digunakan dengan memberikan ekstensi sebagai respons terhadap permintaan serta jika terjadi error saat memanggil metode API. Agar berhasil, "OK"
harus digunakan.
Enum
"FAILED"
"IN_USE"
"ACCESS_DENIED"
"TOO_MANY_OPENED"
"NO_MEMORY"
"NO_SPACE"
"NOT_A_DIRECTORY"
"INVALID_OPERATION"
"ABORT"
"NOT_A_FILE"
"INVALID_URL"
"IO"
ReadDirectoryRequestedOptions
Properti
-
directoryPath
string
Jalur direktori yang berisi konten yang diminta.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
isDirectory
boolean
Chrome 49+Tetapkan ke
true
jika nilaiis_directory
diminta. -
mimeType
boolean
Chrome 49+Tetapkan ke
true
jika nilaimimeType
diminta. -
modificationTime
boolean
Chrome 49+Tetapkan ke
true
jika nilaimodificationTime
diminta. -
name
boolean
Chrome 49+Tetapkan ke
true
jika nilainame
diminta. -
requestId
angka
ID unik permintaan ini.
-
ukuran
boolean
Chrome 49+Tetapkan ke
true
jika nilaisize
diminta. -
gambar mini
boolean
Chrome 49+Tetapkan ke
true
jika nilaithumbnail
diminta.
ReadFileRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
length
angka
Jumlah byte yang akan ditampilkan.
-
offset
angka
Posisikan dalam file (dalam byte) untuk mulai membaca.
-
openRequestId
angka
ID permintaan yang digunakan untuk membuka file.
-
requestId
angka
ID unik permintaan ini.
RemoveWatcherRequestedOptions
Properti
-
entryPath
string
Jalur entri yang dipantau.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
rekursif
boolean
Mode watcher.
-
requestId
angka
ID unik permintaan ini.
TruncateRequestedOptions
Properti
-
filePath
string
Jalur file yang akan dipotong.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
length
angka
Jumlah byte yang akan dipertahankan setelah operasi selesai.
-
requestId
angka
ID unik permintaan ini.
UnmountOptions
Properti
-
fileSystemId
string
ID sistem file yang akan dilepas.
UnmountRequestedOptions
Properti
-
fileSystemId
string
ID sistem file yang akan dilepas.
-
requestId
angka
ID unik permintaan ini.
Watcher
Properti
-
entryPath
string
Jalur entri yang diamati.
-
lastTag
string opsional
Tag yang digunakan oleh notifikasi terakhir untuk penonton.
-
rekursif
boolean
Apakah menonton harus menyertakan semua entri turunan secara rekursif. Ini bisa berlaku hanya untuk direktori.
WriteFileRequestedOptions
Properti
-
data
ArrayBuffer
Buffering byte yang akan ditulis ke file.
-
fileSystemId
string
ID sistem file yang terkait dengan operasi ini.
-
offset
angka
Posisikan dalam file (dalam byte) untuk mulai menulis byte.
-
openRequestId
angka
ID permintaan yang digunakan untuk membuka file.
-
requestId
angka
ID unik permintaan ini.
Metode
get()
chrome.fileSystemProvider.get(
fileSystemId: string,
callback?: function,
)
Menampilkan informasi tentang sistem file dengan fileSystemId
yang diteruskan.
Parameter
-
fileSystemId
string
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(fileSystem: FileSystemInfo) => void
-
fileSystem
-
Hasil
-
Promise<FileSystemInfo>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
getAll()
chrome.fileSystemProvider.getAll(
callback?: function,
)
Menampilkan semua sistem file yang dipasang oleh ekstensi.
Parameter
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(fileSystems: FileSystemInfo[]) => void
-
fileSystems
-
Hasil
-
Promise<FileSystemInfo[]>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
mount()
chrome.fileSystemProvider.mount(
options: MountOptions,
callback?: function,
)
Memasang sistem file dengan fileSystemId
dan displayName
yang ditentukan. displayName
akan ditampilkan di panel kiri aplikasi File. displayName
dapat berisi karakter apa pun termasuk '/', tetapi tidak boleh berupa string kosong. displayName
harus deskriptif, tetapi tidak harus unik. fileSystemId
tidak boleh berupa string kosong.
Bergantung pada jenis sistem file yang dipasang, opsi source
harus disetel dengan tepat.
Jika terjadi error, runtime.lastError
akan disetel dengan kode error yang sesuai.
Parameter
-
opsi
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
notify()
chrome.fileSystemProvider.notify(
options: NotifyOptions,
callback?: function,
)
Memberi tahu tentang perubahan dalam direktori yang dipantau pada observedPath
dalam mode recursive
. Jika sistem file dipasang dengan supportsNotifyTag
, tag
harus diberikan, dan semua perubahan sejak notifikasi terakhir selalu dilaporkan, meskipun sistem dimatikan. Tag terakhir dapat diperoleh dengan getAll
.
Untuk menggunakan, opsi manifes file_system_provider.notify
harus disetel ke benar (true).
Nilai tag
dapat berupa string apa pun yang unik per panggilan, sehingga notifikasi yang terakhir dapat diidentifikasi dapat diidentifikasi. Misalnya, jika ekstensi penyedia dimulai setelah dimulai ulang, dan tag notifikasi yang terakhir didaftarkan sama dengan "123", ekstensi tersebut harus memanggil notify
untuk semua perubahan yang terjadi sejak perubahan diberi tag sebagai "123". Tidak boleh berupa string kosong.
Tidak semua penyedia dapat menyediakan tag, tetapi jika sistem file memiliki {i>changelog<i}, maka tag tersebut bisa berupa nomor perubahan, atau nomor revisi.
Perhatikan bahwa jika direktori induk dihapus, maka semua entri turunan juga akan dihapus, dan jika entri ditonton, API harus diberi tahu tentang fakta tersebut. Juga, jika direktori diganti namanya, maka semua entri turunan benar-benar dihapus, karena tidak ada entri lagi di bawah jalur aslinya.
Jika terjadi error, kode error yang sesuai akan ditetapkan ke runtime.lastError
.
Parameter
-
opsi
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
unmount()
chrome.fileSystemProvider.unmount(
options: UnmountOptions,
callback?: function,
)
Melepas sistem file dengan fileSystemId
yang ditentukan. Atribut ini harus dipanggil setelah onUnmountRequested
dipanggil. Selain itu, ekstensi penyedia dapat memutuskan untuk melakukan pelepasan jika tidak diminta (misalnya jika koneksi terputus, atau error file).
Jika terjadi error, runtime.lastError
akan disetel dengan kode error yang sesuai.
Parameter
-
opsi
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
Acara
onAbortRequested
chrome.fileSystemProvider.onAbortRequested.addListener(
callback: function,
)
Dikeluarkan saat membatalkan operasi dengan operationRequestId
diminta. Operasi yang dijalankan dengan operationRequestId
harus segera dihentikan dan successCallback
dari permintaan pembatalan ini dijalankan. Jika pembatalan gagal, errorCallback
harus dipanggil. Perhatikan, callback operasi yang dibatalkan tidak boleh dipanggil, karena akan diabaikan. Meskipun memanggil errorCallback
, permintaan tersebut mungkin dibatalkan secara paksa.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onAddWatcherRequested
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
callback: function,
)
Dinaikkan saat menyetel pengamat direktori baru diminta. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onCloseFileRequested
chrome.fileSystemProvider.onCloseFileRequested.addListener(
callback: function,
)
Dinaikkan saat membuka file yang sebelumnya dibuka dengan openRequestId
akan diminta untuk ditutup.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onConfigureRequested
chrome.fileSystemProvider.onConfigureRequested.addListener(
callback: function,
)
Dinaikkan saat menampilkan dialog konfigurasi untuk fileSystemId
diminta. Jika ditangani, opsi minimum file_system_provider.configurable
harus ditetapkan ke true.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onCopyEntryRequested
chrome.fileSystemProvider.onCopyEntryRequested.addListener(
callback: function,
)
Dinaikkan saat menyalin entri (secara berulang jika direktori) diminta. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onCreateDirectoryRequested
chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
callback: function,
)
Ditinggikan saat membuat direktori diminta. Operasi harus gagal dengan error EXISTS jika direktori target sudah ada. Jika recursive
bernilai benar, semua direktori yang tidak ada di jalur direktori harus dibuat.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onCreateFileRequested
chrome.fileSystemProvider.onCreateFileRequested.addListener(
callback: function,
)
Dikeluarkan saat membuat file diminta. Jika file sudah ada, errorCallback
harus dipanggil dengan kode error "EXISTS"
.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onDeleteEntryRequested
chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
callback: function,
)
Diangkat saat penghapusan entri diminta. Jika recursive
bernilai benar, dan entrinya adalah direktori, maka semua entri di dalamnya harus dihapus secara rekursif juga.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onExecuteActionRequested
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
callback: function,
)
Dinaikkan saat menjalankan tindakan untuk sekumpulan file atau direktori diminta. Setelah tindakan selesai, successCallback
harus dipanggil. Jika error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onGetActionsRequested
chrome.fileSystemProvider.onGetActionsRequested.addListener(
callback: function,
)
Dinaikkan saat daftar tindakan untuk serangkaian file atau direktori di entryPaths
diminta. Semua tindakan yang ditampilkan harus dapat diterapkan untuk setiap entri. Jika tidak ada tindakan seperti itu, array kosong harus ditampilkan. Tindakan harus ditampilkan dengan panggilan successCallback
. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:(actions: Action[]) => void
-
tindakan
Tindakan[]
-
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onGetMetadataRequested
chrome.fileSystemProvider.onGetMetadataRequested.addListener(
callback: function,
)
Dinaikkan saat metadata file atau direktori di entryPath
diminta. Metadata harus ditampilkan dengan panggilan successCallback
. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:(metadata: EntryMetadata) => void
-
metadata
-
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onMountRequested
chrome.fileSystemProvider.onMountRequested.addListener(
callback: function,
)
Dikeluarkan saat menampilkan dialog untuk memasang sistem file baru akan diminta. Jika ekstensi/aplikasi adalah pengendali file, peristiwa ini tidak boleh ditangani. Sebagai gantinya, app.runtime.onLaunched
harus ditangani untuk memasang sistem file baru saat file dibuka. Untuk beberapa pemasangan, opsi manifes file_system_provider.multiple_mounts
harus disetel ke benar (true).
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
-
onMoveEntryRequested
chrome.fileSystemProvider.onMoveEntryRequested.addListener(
callback: function,
)
Dinaikkan saat memindahkan entri (secara berulang jika direktori) diminta. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onOpenFileRequested
chrome.fileSystemProvider.onOpenFileRequested.addListener(
callback: function,
)
Dinaikkan saat membuka file di filePath
diminta. Jika file tidak ada, maka operasi harus gagal. Jumlah file maksimum yang dibuka sekaligus dapat ditentukan dengan MountOptions
.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:(metadata?: EntryMetadata) => void
-
metadata
EntryMetadata opsional
-
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onReadDirectoryRequested
chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
callback: function,
)
Dinaikkan saat konten direktori di directoryPath
diminta. Hasilnya harus ditampilkan dalam potongan dengan memanggil successCallback
beberapa kali. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:(entries: EntryMetadata[], hasMore: boolean) => void
-
entries
-
hasMore
boolean
-
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onReadFileRequested
chrome.fileSystemProvider.onReadFileRequested.addListener(
callback: function,
)
Dimunculkan saat membaca konten file yang dibuka sebelumnya dengan openRequestId
diminta. Hasilnya harus ditampilkan dalam potongan dengan memanggil successCallback
beberapa kali. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:(data: ArrayBuffer, hasMore: boolean) => void
-
data
ArrayBuffer
-
hasMore
boolean
-
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onRemoveWatcherRequested
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
callback: function,
)
Dinaikkan saat watcher harus dihapus. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onTruncateRequested
chrome.fileSystemProvider.onTruncateRequested.addListener(
callback: function,
)
Dinaikkan saat diminta memotong file ke panjang yang diinginkan. Jika terjadi error, errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onUnmountRequested
chrome.fileSystemProvider.onUnmountRequested.addListener(
callback: function,
)
Dinaikkan saat melepas untuk sistem file dengan ID fileSystemId
diminta. Dalam respons, metode API unmount
harus dipanggil bersama dengan successCallback
. Jika pelepasan tidak memungkinkan (misalnya, karena operasi yang tertunda), errorCallback
harus dipanggil.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-
onWriteFileRequested
chrome.fileSystemProvider.onWriteFileRequested.addListener(
callback: function,
)
Dinaikkan saat menulis konten ke file yang dibuka sebelumnya dengan openRequestId
diminta.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
successCallback
fungsi
Parameter
successCallback
terlihat seperti:() => void
-
errorCallback
fungsi
Parameter
errorCallback
terlihat seperti:(error: ProviderError) => void
-
error
-