chrome.fileSystemProvider

Deskripsi

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

Izin

fileSystemProvider

Ketersediaan

Khusus ChromeOS

Anda harus mendeklarasikan "fileSystemProvider" izin, dan bagian 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 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 tentang perubahan didukung. Secara default: false.
source (enum "file", "device", atau "network") - 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 ditetapkan ke benar (true), item menu untuk mengonfigurasi volume akan dirender. Demikian pula, jika multiple_mounts disetel ke true, aplikasi File akan memungkinkan untuk menambahkan 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 segera diterapkan dan otomatis.

Ringkasan

File System Provider API memungkinkan ekstensi 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 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 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" Tersedia hanya untuk aplikasi terpaket.
"device" atau "network" onMountRequested

Mengonfigurasi sistem file

Setelah terpasang, sistem file yang disediakan dapat dikonfigurasi melalui peristiwa onConfigureRequested. Hal ini sangat berguna untuk sistem file yang menyediakan konten lewat jaringan guna menetapkan kredensial yang tepat. Menangani peristiwa ini bersifat opsional.

Siklus proses

Sistem file yang disediakan setelah dipasang akan diingat oleh Chrome dan dipasang kembali secara otomatis setelah mulai ulang atau mulai ulang. Oleh karena itu, setelah sistem file dipasang oleh ekstensi penyedia, sistem akan tetap ada hingga ekstensi dihapus muatannya, atau ekstensi memanggil metode lepas.

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

Properti

  • id

    string

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

  • judul

    string opsional

    Judul tindakan. Untuk tindakan umum, Anda dapat mengabaikannya.

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 atau tidak. Ini bisa benar untuk direktori saja.

  • requestId

    angka

    ID unik permintaan ini.

Change

Properti

  • changeType

    ChangeType

    Jenis perubahan yang terjadi pada entri.

  • cloudFileInfo

    CloudFileInfo opsional

    Chrome 125 dan yang lebih baru

    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

"DIUBAH"

"DIHAPUS"

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

Properti

  • versionTag

    string opsional

    Tag yang merepresentasikan versi file.

CloudIdentifier

Chrome 117 dan yang lebih baru

Properti

  • id

    string

    ID penyedia untuk file/direktori tertentu.

  • providerName

    string

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

CommonActionId

Chrome 45 dan yang lebih baru

Daftar tindakan umum. "SHARE" digunakan untuk berbagi file dengan orang lain. "SAVE_FOR_OFFLINE" untuk memasang pin (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

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"BAGIKAN"

ConfigureRequestedOptions

Chrome 44 dan yang lebih baru

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 (khusus 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 (khusus direktori).

  • requestId

    angka

    ID unik permintaan ini.

EntryMetadata

Properti

  • cloudFileInfo

    CloudFileInfo opsional

    Chrome 125 dan yang lebih baru

    Informasi yang mengidentifikasi file tertentu dalam sistem file cloud yang mendasarinya. Harus diberikan jika diminta dalam 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 dalam options dan file didukung oleh penyimpanan cloud. Untuk file lokal yang tidak didukung oleh penyimpanan cloud, file tersebut harus tidak ditentukan saat diminta.

  • Direktori

    boolean opsional

    True 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, parameter ini harus kosong. Harus diberikan jika diminta dalam options.

  • ukuran

    angka 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, berukuran maksimal 32 KB. Opsional, tetapi hanya dapat diberikan jika diminta secara eksplisit oleh peristiwa onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45 dan yang lebih baru

Properti

  • actionId

    string

    ID tindakan yang akan dieksekusi.

  • entryPaths

    {i>string<i}[]

    Chrome 47 dan yang lebih baru

    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, maka tidak dibatasi.

  • supportsNotifyTag

    boolean opsional

    Chrome 45 dan yang lebih baru

    Apakah sistem file mendukung kolom tag untuk mengamati direktori.

  • watcher

    Pengamat[]

    Chrome 45 dan yang lebih baru

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

Properti

  • entryPaths

    {i>string<i}[]

    Chrome 47 dan yang lebih baru

    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 baru

    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.

  • Direktori

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai is_directory diminta.

  • mimeType

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai mimeType diminta.

  • modificationTime

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai modificationTime diminta.

  • nama

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai name diminta.

  • requestId

    angka

    ID unik permintaan ini.

  • ukuran

    boolean

    Chrome 49 dan yang lebih baru

    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

    Pengidentifikasi string sistem file. Harus unik untuk setiap ekstensi.

  • openedFilesLimit

    angka 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. True secara default.

  • supportsNotifyTag

    boolean opsional

    Chrome 45 dan yang lebih baru

    Apakah sistem file mendukung kolom tag untuk direktori yang diamati atau tidak.

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

    Tag untuk notifikasi. Wajib ada jika sistem file terpasang dengan opsi supportsNotifyTag. Perlu diperhatikan bahwa flag ini diperlukan untuk memberikan notifikasi tentang perubahan yang berubah meskipun sistem dimatikan.

OpenedFile

Properti

  • filePath

    string

    Jalur file yang dibuka.

  • Apakah file dibuka untuk membaca atau menulis.

  • openRequestId

    angka

    ID permintaan yang akan digunakan oleh permintaan baca/tulis dan tutup yang berurutan.

OpenFileMode

Mode membuka file. Digunakan oleh onOpenFileRequested.

Enum

"BACA"

"TULIS"

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 secara berurutan.

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

"Oke"

"FAILED"

"IN_USE"

"EXISTS"

"TIDAK_DITEMUKAN"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"KEAMANAN"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Properti

  • directoryPath

    string

    Jalur direktori tempat konten diminta.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • Direktori

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai is_directory diminta.

  • mimeType

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai mimeType diminta.

  • modificationTime

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai modificationTime diminta.

  • nama

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai name diminta.

  • requestId

    angka

    ID unik permintaan ini.

  • ukuran

    boolean

    Chrome 49 dan yang lebih baru

    Tetapkan ke true jika nilai size diminta.

  • thumbnail

    boolean

    Chrome 49 dan yang lebih baru

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

  • lastTag

    string opsional

    Tag yang digunakan oleh notifikasi terakhir untuk watcher.

  • rekursif

    boolean

    Apakah menonton harus menyertakan semua entri turunan secara rekursif atau tidak. Ini bisa benar untuk direktori saja.

WriteFileRequestedOptions

Properti

  • data

    ArrayBuffer

    Buffer byte yang akan ditulis ke file.

  • fileSystemId

    string

    ID sistem file yang terkait dengan operasi ini.

  • offset

    angka

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

Menampilkan informasi tentang sistem file dengan fileSystemId yang diteruskan.

Parameter

  • fileSystemId

    string

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (fileSystem: FileSystemInfo) => void

Hasil

  • Promise&lt;FileSystemInfo&gt;

    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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getAll()

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

Menampilkan semua sistem file yang terpasang oleh ekstensi.

Parameter

Hasil

  • Promise&lt;FileSystemInfo[]&gt;

    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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

mount()

Janji 
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 ditetapkan dengan benar.

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

notify()

Janji Chrome 45 dan yang lebih baru 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

Memberi tahu perubahan di direktori yang dipantau pada observedPath dalam mode recursive. Jika sistem file terpasang 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 mengidentifikasi notifikasi yang terakhir didaftarkan. Misalnya, jika ekstensi yang menyediakan dimulai setelah reboot, dan tag notifikasi yang terakhir didaftarkan sama dengan "123", tag tersebut harus memanggil notify untuk semua perubahan yang terjadi sejak perubahan diberi tag "123". Nilainya tidak boleh berupa string kosong.

Tidak semua penyedia dapat menyediakan {i>tag<i}, tetapi jika sistem file memiliki {i>changelog<i}, maka tagnya bisa berupa, nomor perubahan, atau nomor revisi.

Perhatikan bahwa jika direktori induk dihapus, semua entri turunan juga akan dihapus. Jika diamati, API harus diberi tahu tentang fakta tersebut. Juga, jika sebuah direktori diganti namanya, maka semua entri turunan akan dihapus, karena tidak ada lagi entri pada jalur aslinya.

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

unmount()

Janji 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

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

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onAbortRequested

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

Diajukan 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 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 ini: 

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

onAddWatcherRequested

Chrome 45 dan yang lebih baru 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onCloseFileRequested

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onConfigureRequested

Chrome 44 dan yang lebih baru 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onCopyEntryRequested

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onCreateDirectoryRequested

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

Dinaikkan saat pembuatan direktori diminta. Operasi harus gagal dengan error EXISTS jika direktori target sudah ada. Jika recursive benar, semua direktori yang hilang di jalur direktori harus dibuat.

Parameter

onCreateFileRequested

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onDeleteEntryRequested

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

Diajukan saat menghapus entri diminta. Jika recursive bernilai benar (true), dan entrinya adalah direktori, semua entri di dalamnya juga harus dihapus secara rekursif.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onExecuteActionRequested

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

Dinaikkan saat mengeksekusi tindakan untuk sekumpulan file atau direktori. Setelah tindakan selesai, successCallback harus dipanggil. Jika terjadi error, errorCallback harus dipanggil.

Parameter

onGetActionsRequested

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

Diangkat saat daftar tindakan untuk sekumpulan file atau direktori di entryPaths diminta. Semua tindakan yang ditampilkan harus berlaku 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 dan yang lebih baru 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Dinaikkan saat menampilkan dialog untuk memasang sistem file baru. Jika ekstensi/aplikasi adalah pengendali file, maka 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 ini: 

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

    • successCallback

      fungsi

      Parameter successCallback terlihat seperti ini: 

      () => void

    • errorCallback

      fungsi

      Parameter errorCallback terlihat seperti ini: 

      (error: ProviderError) => void

onMoveEntryRequested

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onOpenFileRequested

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

Dinaikkan saat membuka file di filePath diminta. Jika file tidak ada, maka operasi harus gagal. Jumlah maksimum file 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,
)

Dinaikkan 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 ini: 

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

    • successCallback

      fungsi

      Parameter successCallback terlihat seperti ini: 

      (data: ArrayBuffer, hasMore: boolean) => void

      • data

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      fungsi

      Parameter errorCallback terlihat seperti ini: 

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 dan yang lebih baru 
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 memotong file sesuai panjang yang diinginkan. Jika terjadi error, errorCallback harus dipanggil.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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

onUnmountRequested

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

Dinaikkan saat pelepasan sistem file dengan ID fileSystemId diminta. Dalam responsnya, metode unmount API 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 ini: 

    (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

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

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