chrome.fileSystemProvider

Deskripsi

Gunakan chrome.fileSystemProvider API untuk membuat sistem file yang dapat diakses dari pengelola file di Chrome OS.

Izin

fileSystemProvider

Ketersediaan

Khusus ChromeOS

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

Chrome 45+

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

    Tertunda

    Informasi 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

Tertunda

Properti

  • versionTag

    string opsional

    Tag yang mewakili versi file.

CloudIdentifier

Chrome 117 dan yang lebih baru

Properti

  • id

    string

    ID penyedia untuk file/direktori yang ditentukan.

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

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

    Tertunda

    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 dan yang lebih baru

    Representasi 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

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

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

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

    Tertunda

    Tetapkan ke true jika nilai cloudFileInfo diminta.

  • cloudIdentifier

    boolean

    Chrome 117 dan yang lebih baru

    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.

  • name

    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.

  • gambar mini

    boolean

    Tetapkan ke true jika nilai thumbnail 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 baru

    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

    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.

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

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

  • name

    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.

  • gambar mini

    boolean

    Chrome 49+

    Tetapkan ke true jika nilai thumbnail 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()

Promise
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

Hasil

  • Chrome 96 dan yang lebih baru

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

Promise
chrome.fileSystemProvider.getAll(
  callback?: function,
)

Menampilkan semua sistem file yang dipasang oleh ekstensi.

Parameter

Hasil

  • Promise<FileSystemInfo[]>

    Chrome 96 dan yang lebih baru

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

Promise
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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti:

    ()=>void

Hasil

  • Promise<void>

    Chrome 96 dan yang lebih baru

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

Promise Chrome 45+
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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti:

    ()=>void

Hasil

  • Promise<void>

    Chrome 96 dan yang lebih baru

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

Promise
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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti:

    ()=>void

Hasil

  • Promise<void>

    Chrome 96 dan yang lebih baru

    Promise 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

onAddWatcherRequested

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

Dinaikkan saat menyetel pengamat direktori baru diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onCloseFileRequested

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

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

Parameter

onConfigureRequested

Chrome 44+
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

onCopyEntryRequested

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

Dinaikkan saat menyalin entri (secara berulang jika direktori) diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

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

onCreateFileRequested

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

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

Parameter

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

onExecuteActionRequested

Chrome 48+
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

onGetActionsRequested

Chrome 48+
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

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

onMountRequested

Chrome 44+
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

onMoveEntryRequested

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

Dinaikkan saat memindahkan entri (secara berulang jika direktori) diminta. Jika terjadi error, errorCallback harus dipanggil.

Parameter

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

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

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

onRemoveWatcherRequested

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

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

Parameter

onTruncateRequested

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

Dinaikkan saat diminta memotong file ke panjang yang diinginkan. Jika terjadi error, errorCallback harus dipanggil.

Parameter

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

onWriteFileRequested

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

Dinaikkan saat menulis konten ke file yang dibuka sebelumnya dengan openRequestId diminta.

Parameter