chrome.fileSystemProvider

Deskripsi

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

Izin

fileSystemProvider

Ketersediaan

Khusus ChromeOS

Manifes

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

Aplikasi File 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 pemantau, sehingga perubahan pada sistem file dapat langsung dan otomatis tercermin.

Ringkasan

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

Memasang sistem file

Penyedia ekstensi 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 yang dipaketkan, karena peristiwa onLaunched tidak tersedia untuk ekstensi.

Jika sumbernya adalah jaringan atau perangkat, sistem file harus di-mount saat peristiwa onMountRequested dipanggil.

Sumber data sistem file Titik entri
"file" Hanya tersedia untuk aplikasi 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. Oleh karena itu, setelah sistem file di-mount oleh ekstensi penyedia, sistem file 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 atau CommonActionId untuk tindakan umum.

  • judul

    string opsional

    Judul tindakan. Tindakan 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 rekursif. Hal ini hanya dapat berlaku 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 di 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 merepresentasikan 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 menyematkan (menyimpan untuk akses offline). "OFFLINE_NOT_NECESSARY" untuk memberi tahu bahwa file tidak perlu lagi disimpan 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 untuk 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 harus tidak ditentukan saat diminta.

  • isDirectory

    boolean opsional

    Benar jika berupa direktori. Harus diberikan jika diminta dalam options.

  • mimeType

    string opsional

    Jenis MIME untuk entri. Selalu opsional, tetapi harus diberikan jika diminta di options.

  • modificationTime

    Tanggal opsional

    Waktu terakhir diubah dari entri ini. Harus diberikan jika diminta dalam options.

  • nama

    string opsional

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

  • ukuran

    nomor opsional

    Ukuran file dalam byte. Harus diberikan jika diminta dalam 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 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

  • Nama Tampilan

    string

    Nama yang dapat dibaca manusia untuk sistem file.

  • fileSystemId

    string

    ID sistem file.

  • openedFiles

    OpenedFile[]

    Daftar file yang saat ini terbuka.

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

  • penonton

    Watcher[]

    Chrome 45+

    Daftar penonton.

  • 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 untuk mengambil metadata.

  • 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

    String ID 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+

    Apakah 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

    ChangeType

    Jenis perubahan yang terjadi pada entri yang diamati. Jika dihapus (DELETED), entri yang diamati akan otomatis dihapus 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

    Tag untuk notifikasi. Diperlukan jika sistem file dipasang dengan opsi supportsNotifyTag. Perhatikan bahwa tanda ini diperlukan untuk memberikan notifikasi tentang perubahan yang terjadi meskipun sistem dimatikan.

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 membuka file. Digunakan oleh onOpenFileRequested.

Enum

"BACA"

"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 menyediakan ekstensi sebagai respons terhadap permintaan serta jika terjadi error saat memanggil metode API. Agar berhasil, "OK" harus digunakan.

Enum

"OK"

"GAGAL"

"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 ditonton.

  • 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 dipangkas.

  • 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 pengamat.

  • rekursif

    boolean

    Apakah menonton harus menyertakan semua entri turunan secara rekursif. Hal ini hanya dapat berlaku 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()

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

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

getAll()

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

Menampilkan semua sistem file yang di-mount oleh ekstensi.

Parameter

Hasil

  • Promise<FileSystemInfo[]>

    Chrome 96+

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

mount()

Janji 
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 disetel dengan tepat.

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

    Promise hanya didukung untuk Manifest 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 di direktori yang dipantau pada observedPath dalam mode recursive. Jika sistem file di-mount dengan supportsNotifyTag, maka tag harus diberikan, dan semua perubahan sejak notifikasi terakhir selalu dilaporkan, meskipun sistem dimatikan. Tag terakhir dapat diperoleh dengan getAll.

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

Nilai tag dapat berupa string apa pun yang unik per panggilan, sehingga notifikasi terakhir yang terdaftar dapat diidentifikasi. Misalnya, jika ekstensi yang menyediakan data dimulai setelah perangkat dimulai ulang, dan tag notifikasi terakhir yang terdaftar sama dengan "123", maka ekstensi tersebut harus memanggil notify untuk semua perubahan yang terjadi sejak perubahan yang diberi tag "123". Tidak boleh berupa string kosong.

Tidak semua penyedia dapat menyediakan tag, tetapi jika sistem file memiliki log perubahan, maka tag dapat berupa, misalnya, nomor perubahan, atau nomor revisi.

Perhatikan bahwa jika direktori induk dihapus, semua entri turunan juga akan dihapus, dan jika 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 disetel dengan kode error yang sesuai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

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

unmount()

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

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

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 96+

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

Acara

onAbortRequested

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

Dimunculkan saat pembatalan operasi dengan operationRequestId diminta. Operasi yang dijalankan dengan operationRequestId harus segera dihentikan dan successCallback permintaan pembatalan ini dijalankan. Jika pembatalan gagal, errorCallback harus dipanggil. Perhatikan bahwa callback operasi yang dibatalkan tidak boleh dipanggil, karena akan diabaikan. Meskipun memanggil errorCallback, permintaan dapat 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 menyetel pemantau direktori baru diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onCloseFileRequested

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

Dimunculkan saat penutupan file yang sebelumnya dibuka dengan openRequestId diminta.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onConfigureRequested

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

Dimunculkan saat menampilkan dialog konfigurasi untuk fileSystemId diminta. Jika ditangani, opsi manifes file_system_provider.configurable harus disetel ke benar (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 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 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 benar, dan entri adalah direktori, maka semua entri di dalamnya juga harus dihapus secara rekursif.

Parameter

onExecuteActionRequested

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

Dimunculkan 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 handler 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

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,
)

Ditampilkan saat membuka file di filePath diminta. Jika file tidak ada, operasi harus 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 bagian dengan memanggil successCallback beberapa kali. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onReadFileRequested

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

Dimunculkan saat membaca isi file yang sebelumnya dibuka dengan openRequestId diminta. Hasil harus ditampilkan dalam bagian 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 pemantau harus dihapus. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onTruncateRequested

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

Dimunculkan 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,
)

Diajukan saat pelepasan sistem file dengan ID fileSystemId diminta. Dalam respons, metode API unmount harus dipanggil bersama dengan successCallback. Jika pelepasan tidak memungkinkan (mis. karena operasi tertunda), maka errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

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

onWriteFileRequested

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

Muncul 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