chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.fileSystemProvider API untuk membuat sistem file, yang dapat diakses dari pengelola file di ChromeOS.

Izin

fileSystemProvider

Ketersediaan

Khusus ChromeOS

Manifes

Anda harus mendeklarasikan izin dan bagian "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 onConfigureRequested 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 setelan watcher dan notifikasi tentang perubahan didukung. Secara default: false.
source (enum "file", "device", atau "network") - wajib
Sumber data untuk sistem file yang terpasang.

Aplikasi Files menggunakan informasi di atas untuk merender elemen UI terkait dengan tepat. Misalnya, jika configurable ditetapkan ke benar (true), item menu untuk mengonfigurasi volume akan dirender. Demikian pula, jika multiple_mounts ditetapkan ke true, aplikasi Files akan mengizinkan penambahan lebih dari satu direktori 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 terlihat dan otomatis.

Ringkasan

File System Provider API memungkinkan ekstensi mendukung sistem file virtual, yang tersedia di pengelola file di ChromeOS. Kasus penggunaan mencakup mendekompresi arsip dan mengakses file di layanan cloud selain Drive.

Memasang sistem file

Ekstensi penyedia dapat menyediakan 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 dalam paket, 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 dalam paket.
"device" atau "network" onMountRequested

Mengonfigurasi sistem file

Sistem file yang disediakan setelah dipasang dapat dikonfigurasi melalui peristiwa onConfigureRequested. Hal ini sangat berguna untuk sistem file yang menyediakan konten melalui jaringan untuk menetapkan kredensial yang tepat. Penanganan peristiwa ini bersifat opsional.

Siklus proses

Sistem file yang disediakan setelah dipasang akan diingat oleh Chrome dan dipasang ulang secara otomatis setelah dimulai ulang atau dimulai ulang. Oleh karena itu, setelah sistem file dipasang oleh ekstensi penyedia, sistem file tersebut akan tetap ada hingga ekstensi dibongkar, atau ekstensi memanggil metode unmount.

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

Chrome 45+

Properti

  • id

    string

    ID tindakan. String apa pun atau CommonActionId untuk tindakan umum.

  • judul

    string opsional

    Judul tindakan. Parameter ini dapat diabaikan untuk tindakan umum.

AddWatcherRequestedOptions

Properti

  • entryPath

    string

    Jalur entri yang akan diamati.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • rekursif

    boolean

    Apakah pengamatan harus menyertakan semua entri turunan secara berulang. Nilainya hanya dapat berupa true untuk direktori.

  • requestId

    angka

    ID unik permintaan ini.

Change

Properti

  • changeType

    ChangeType

    Jenis perubahan yang terjadi pada entri.

  • cloudFileInfo

    CloudFileInfo opsional

    Chrome 125+

    Informasi yang terkait dengan file jika didukung oleh sistem file cloud.

  • entryPath

    string

    Jalur entri yang diubah.

ChangeType

Jenis perubahan yang terdeteksi pada direktori yang diamati.

Enum

"CHANGED"

"DELETED"

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

Chrome 125+

Properti

  • versionTag

    string opsional

    Tag yang mewakili versi file.

CloudIdentifier

Chrome 117+

Properti

  • id

    string

    ID penyedia untuk file/direktori tertentu.

  • providerName

    string

    ID untuk penyedia penyimpanan cloud (misalnya, 'drive.google.com').

CommonActionId

Chrome 45+

Daftar tindakan umum. "SHARE" digunakan untuk berbagi file dengan orang lain. "SAVE_FOR_OFFLINE" untuk penyematan (menyimpan untuk akses offline). "OFFLINE_NOT_NECESSARY" untuk memberi tahu bahwa file tidak perlu disimpan lagi untuk akses offline. Digunakan oleh onGetActionsRequested dan onExecuteActionRequested.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"BAGIKAN"

ConfigureRequestedOptions

Chrome 44+

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 bersifat 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 bersifat rekursif (hanya untuk direktori).

  • requestId

    angka

    ID unik permintaan ini.

EntryMetadata

Properti

  • cloudFileInfo

    CloudFileInfo opsional

    Chrome 125+

    Informasi 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+

    Representasi penyimpanan cloud dari entri ini. Harus diberikan jika diminta di options dan file didukung oleh penyimpanan cloud. Untuk file lokal yang tidak didukung oleh penyimpanan cloud, file tersebut tidak boleh ditentukan saat diminta.

  • isDirectory

    boolean opsional

    True jika berupa 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 entri ini diubah. Harus diberikan jika diminta di options.

  • nama

    string opsional

    Nama entri ini (bukan nama jalur lengkap). Tidak boleh berisi '/'. Untuk root, harus kosong. Harus diberikan jika diminta di options.

  • ukuran

    number opsional

    Ukuran file dalam byte. Harus diberikan jika diminta di options.

  • thumbnail

    string opsional

    Gambar thumbnail sebagai URI data dalam format PNG, JPEG, atau WEBP, dengan ukuran maksimal 32 KB. Opsional, tetapi hanya dapat diberikan jika diminta secara eksplisit oleh peristiwa onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45+

Properti

  • actionId

    string

    ID tindakan yang akan dijalankan.

  • 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

  • Nama Tampilan

    string

    Nama yang dapat dibaca manusia untuk sistem file.

  • fileSystemId

    string

    ID sistem file.

  • openedFiles

    OpenedFile[]

    Daftar file yang saat ini dibuka.

  • openedFilesLimit

    angka

    Jumlah maksimum file yang dapat dibuka sekaligus. Jika 0, tidak dibatasi.

  • supportsNotifyTag

    boolean opsional

    Chrome 45+

    Apakah sistem file mendukung kolom tag untuk mengamati direktori.

  • watchers

    Watcher[]

    Chrome 45+

    Daftar pengamat.

  • dapat ditulis

    boolean

    Apakah sistem file mendukung operasi yang dapat mengubah konten sistem file (seperti membuat, menghapus, atau menulis ke file).

GetActionsRequestedOptions

Chrome 45+

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+

    Tetapkan ke true jika nilai cloudFileInfo diminta.

  • cloudIdentifier

    boolean

    Chrome 117+

    Tetapkan ke true jika nilai cloudIdentifier diminta.

  • entryPath

    string

    Jalur entri yang metadatanya akan diambil.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • isDirectory

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai is_directory diminta.

  • mimeType

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai mimeType diminta.

  • modificationTime

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai modificationTime diminta.

  • nama

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai name diminta.

  • requestId

    angka

    ID unik permintaan ini.

  • ukuran

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai size diminta.

  • thumbnail

    boolean

    Tetapkan ke true jika nilai thumbnail diminta.

MountOptions

Properti

  • Nama Tampilan

    string

    Nama yang dapat dibaca manusia untuk sistem file.

  • fileSystemId

    string

    ID string sistem file. Harus unik untuk setiap ekstensi.

  • openedFilesLimit

    number opsional

    Jumlah maksimum file yang dapat dibuka sekaligus. Jika tidak ditentukan, atau 0, maka tidak dibatasi.

  • persistent

    boolean opsional

    Chrome 64+

    Apakah framework harus melanjutkan sistem file pada sesi login berikutnya. True 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

    ChangeType

    Jenis perubahan yang terjadi pada entri yang diamati. Jika statusnya DELETED, entri yang diamati akan otomatis dihapus dari daftar entri yang diamati.

  • perubahan

    Change[] 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

    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 dinonaktifkan.

OpenedFile

Properti

  • filePath

    string

    Jalur file yang dibuka.

  • Apakah file dibuka untuk dibaca atau ditulis.

  • openRequestId

    angka

    ID permintaan yang akan digunakan oleh permintaan baca/tulis dan tutup berturut-turut.

OpenFileMode

Mode pembukaan file. Digunakan oleh onOpenFileRequested.

Enum

"READ"

"WRITE"

OpenFileRequestedOptions

Properti

  • filePath

    string

    Jalur file yang akan dibuka.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • Apakah file 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

"OK"

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Properti

  • directoryPath

    string

    Jalur direktori yang kontennya diminta.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • isDirectory

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai is_directory diminta.

  • mimeType

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai mimeType diminta.

  • modificationTime

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai modificationTime diminta.

  • nama

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai name diminta.

  • requestId

    angka

    ID unik permintaan ini.

  • ukuran

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai size diminta.

  • thumbnail

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai thumbnail diminta.

ReadFileRequestedOptions

Properti

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • panjang

    angka

    Jumlah byte yang akan ditampilkan.

  • offset

    angka

    Posisi 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.

  • panjang

    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 sedang diamati.

  • lastTag

    string opsional

    Tag yang digunakan oleh notifikasi terakhir untuk watcher.

  • rekursif

    boolean

    Apakah pemantauan harus menyertakan semua entri turunan secara rekursif. Nilainya hanya dapat berupa true untuk direktori.

WriteFileRequestedOptions

Properti

  • data

    ArrayBuffer

    Buffer byte yang akan ditulis ke file.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • offset

    angka

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

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

Menampilkan informasi tentang sistem file dengan fileSystemId yang diteruskan.

Parameter

  • fileSystemId

    string

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (fileSystem: FileSystemInfo) => void

Hasil

  • Promise<FileSystemInfo>

    Chrome 96+

    Callback untuk menerima hasil fungsi get.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getAll()

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

Menampilkan semua sistem file yang dipasang oleh ekstensi.

Parameter

Hasil

  • Promise<FileSystemInfo[]>

    Chrome 96+

    Callback untuk menerima hasil fungsi getAll.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

mount()

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

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 ditetapkan dengan tepat.

Jika terjadi error, runtime.lastError akan ditetapkan dengan kode error yang sesuai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

    Callback hasil umum untuk menunjukkan keberhasilan atau kegagalan.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

notify()

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

Memberi tahu tentang perubahan dalam direktori yang dipantau di observedPath dalam mode recursive. Jika sistem file dipasang dengan supportsNotifyTag, tag harus disediakan, dan semua perubahan sejak notifikasi terakhir selalu dilaporkan, meskipun sistem dinonaktifkan. Tag terakhir dapat diperoleh dengan getAll.

Untuk menggunakannya, opsi manifes file_system_provider.notify harus disetel ke true.

Nilai tag dapat berupa string apa pun yang unik per panggilan, sehingga memungkinkan untuk mengidentifikasi notifikasi terakhir yang terdaftar. Misalnya, jika ekstensi penyedia dimulai setelah mulai ulang, dan tag notifikasi terakhir yang terdaftar sama dengan "123", ekstensi tersebut harus memanggil notify untuk semua perubahan yang terjadi sejak perubahan yang diberi tag "123". Kunci tidak boleh berupa string kosong.

Tidak semua penyedia dapat memberikan tag, tetapi jika sistem file memiliki changelog, tag tersebut dapat berupa, misalnya, nomor perubahan atau nomor revisi.

Perhatikan bahwa jika direktori induk dihapus, semua entri turunan juga akan dihapus, dan jika entri tersebut dipantau, API harus diberi tahu tentang fakta tersebut. Selain itu, jika direktori diganti namanya, semua entri turunan akan dihapus, karena tidak ada lagi entri di jalur aslinya.

Jika terjadi error, runtime.lastError akan ditetapkan dengan kode error yang sesuai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

    Callback hasil umum untuk menunjukkan keberhasilan atau kegagalan.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

unmount()

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

Melepas sistem file dengan fileSystemId yang diberikan. Metode ini harus dipanggil setelah onUnmountRequested dipanggil. Selain itu, ekstensi penyedia dapat memutuskan untuk melepas jika tidak diminta (misalnya, jika koneksi terputus, atau terjadi error file).

Jika terjadi error, runtime.lastError akan ditetapkan dengan kode error yang sesuai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

    Callback hasil umum untuk menunjukkan keberhasilan atau kegagalan.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onAbortRequested

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

Dilaporkan saat pembatalan operasi dengan operationRequestId diminta. Operasi yang dijalankan dengan operationRequestId harus segera dihentikan dan successCallback dari permintaan pembatalan ini harus dijalankan. Jika pembatalan gagal, errorCallback harus dipanggil. Perhatikan bahwa callback operasi yang dibatalkan tidak boleh dipanggil, karena akan diabaikan. Meskipun memanggil errorCallback, permintaan mungkin dibatalkan secara paksa.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onAddWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Dimunculkan saat permintaan untuk menetapkan pemantau direktori baru dibuat. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onCloseFileRequested

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

Dimunculkan saat membuka file yang sebelumnya dibuka dengan openRequestId diminta untuk ditutup.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onConfigureRequested

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

Ditampilkan saat menampilkan dialog konfigurasi untuk fileSystemId diminta. Jika ditangani, opsi manifes file_system_provider.configurable harus ditetapkan ke true.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onCopyEntryRequested

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

Ditampilkan saat penyalinan entri (secara rekursif jika berupa direktori) diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onCreateDirectoryRequested

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

Dilaporkan saat pembuatan direktori diminta. Operasi harus gagal dengan error EXISTS jika direktori target sudah ada. Jika recursive bernilai benar (true), semua direktori yang tidak ada di jalur direktori harus dibuat.

Parameter

onCreateFileRequested

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

Dimunculkan saat pembuatan file diminta. Jika file sudah ada, errorCallback harus dipanggil dengan kode error "EXISTS".

Parameter

onDeleteEntryRequested

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

Dilaporkan saat penghapusan entri diminta. Jika recursive bernilai benar, dan entrinya adalah direktori, semua entri di dalamnya juga harus dihapus secara rekursif.

Parameter

onExecuteActionRequested

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

Terjadi saat menjalankan tindakan untuk sekumpulan file atau direktori\ diminta. Setelah tindakan selesai, successCallback harus dipanggil. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onGetActionsRequested

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

Dimunculkan saat daftar tindakan untuk sekumpulan file atau direktori di entryPaths diminta. Semua tindakan yang ditampilkan harus berlaku untuk setiap entri. Jika tidak ada tindakan tersebut, array kosong akan ditampilkan. Tindakan harus ditampilkan dengan panggilan successCallback. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onGetMetadataRequested

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

Dilaporkan saat metadata file atau direktori di entryPath diminta. Metadata harus ditampilkan dengan panggilan successCallback. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onMountRequested

Chrome 44+ 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Dimunculkan saat menampilkan dialog untuk memasang sistem file baru 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 ditetapkan ke 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

onMoveEntryRequested

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

Dilaporkan saat pemindahan entri (secara rekursif jika berupa direktori) diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onOpenFileRequested

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

Dilaporkan saat pembukaan file di filePath diminta. Jika file tidak ada, operasi akan gagal. Jumlah maksimum file yang dibuka sekaligus dapat ditentukan dengan MountOptions.

Parameter

onReadDirectoryRequested

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

Dilaporkan saat konten direktori di directoryPath diminta. Hasil harus ditampilkan dalam potongan dengan memanggil successCallback beberapa kali. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onReadFileRequested

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

Dimunculkan saat pembacaan konten file yang dibuka sebelumnya dengan openRequestId diminta. Hasil 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

onRemoveWatcherRequested

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

Muncul saat watcher harus dihapus. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onTruncateRequested

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

Dilaporkan saat pemotongan file ke panjang yang diinginkan diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onUnmountRequested

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

Dilaporkan saat pelepasan sistem file dengan ID fileSystemId diminta. Dalam respons, metode API unmount harus dipanggil bersama dengan successCallback. Jika pelepasan tidak dapat dilakukan (misalnya, karena operasi yang tertunda), errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onWriteFileRequested

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

Dimunculkan saat penulisan konten ke file yang sebelumnya dibuka dengan openRequestId diminta.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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