chrome.fileBrowserHandler

Deskripsi

Konsep dan penggunaan

Browser file ChromeOS muncul saat pengguna menekan Alt+Shift+M atau menghubungkan perangkat penyimpanan eksternal, seperti kartu SD, kunci USB, drive eksternal, atau kamera digital. Selain menampilkan file di perangkat eksternal, browser file juga dapat menampilkan file yang sebelumnya disimpan pengguna ke sistem.

Saat pengguna memilih satu atau beberapa file, browser file akan menambahkan tombol yang mewakili pengendali yang valid untuk file tersebut. Misalnya, pada screenshot berikut, memilih file dengan akhiran ".png" akan menampilkan tombol "Simpan ke Galeri" yang dapat diklik pengguna.

Izin

Anda harus mendeklarasikan izin "fileBrowserHandler" dalam manifes ekstensi.

Ketersediaan

Anda harus menggunakan kolom "file_browser_handlers" untuk mendaftarkan ekstensi sebagai pengendali setidaknya satu jenis file. Anda juga harus menyediakan ikon 16x16 untuk ditampilkan di tombol. Contoh:

{
  "name": "My extension",
  ...
  "file_browser_handlers": [
    {
      "id": "upload",
      "default_title": "Save to Gallery", // What the button will display
      "file_filters": [
        "filesystem:*.jpg",  // To match all files, use "filesystem:*.*"
        "filesystem:*.jpeg",
        "filesystem:*.png"
      ]
    }
  ],
  "permissions" : [
    "fileBrowserHandler"
  ],
  "icons": {
    "16": "icon16.png",
    "48": "icon48.png",
    "128": "icon128.png"
  },
  ...
}

Menerapkan pengendali browser file

Untuk menggunakan API ini, Anda harus menerapkan fungsi yang menangani peristiwa onExecute dari chrome.fileBrowserHandler. Fungsi Anda akan dipanggil setiap kali pengguna mengklik tombol yang mewakili pengendali browser file Anda. Dalam fungsi Anda, gunakan File System API untuk mendapatkan akses ke konten file. Berikut ini contohnya:

chrome.fileBrowserHandler.onExecute.addListener(async (id, details) => {
  if (id !== 'upload') {
    return;  // check if you have multiple file_browser_handlers
  }

  for (const entry of detail.entries) {
    // the FileSystemFileEntry doesn't have a Promise API, wrap in one
    const file = await new Promise((resolve, reject) => {
      entry.file(resolve, reject);
    });
    const buffer = await file.arrayBuffer();
    // do something with buffer
  }
});

Pengendali peristiwa Anda akan menerima dua argumen:

id

Nilai id dari file manifes. Jika ekstensi Anda menerapkan beberapa pengendali, Anda dapat memeriksa nilai ID untuk melihat pengendali mana yang telah dipicu.

details

Objek yang menjelaskan peristiwa. Anda bisa mendapatkan file yang dipilih pengguna dari kolom entries objek ini, yang merupakan array objek FileSystemFileEntry.

chrome.fileBrowserHandler.onExecute.addListener(
  callback: function,
)