chrome.fileBrowserHandler

说明

概念和用法

当用户按 Alt+Shift+M 或连接外部存储设备（例如 SD 卡、USB 密钥、外部驱动器或数码相机）时，ChromeOS 文件浏览器就会弹出。除了显示外部设备上的文件外，文件浏览器还可以显示用户之前保存到系统中的文件。

当用户选择一个或多个文件时，文件浏览器会添加表示这些文件的有效处理程序的按钮。例如，在以下屏幕截图中，选择带有“.png”后缀的文件会导致系统显示一个供用户点击的“保存到图库”按钮。

权限

您必须在扩展程序清单中声明 "fileBrowserHandler" 权限。

可用性

您必须使用 "file_browser_handlers" 字段将该扩展程序注册为至少一种文件类型的处理程序。您还应提供一个 16 x 16 的图标，以便在按钮上显示。例如：

{   "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"   },   ... } 

实现文件浏览器处理程序

如需使用此 API，您必须实现一个用于处理 chrome.fileBrowserHandler 的 onExecute 事件的函数。每当用户点击表示文件浏览器处理程序的按钮时，系统都会调用您的函数。在函数中，使用 File System API 访问文件内容。示例如下：

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   } }); 

系统会向事件处理程序传递两个参数：

id

清单文件中的 id 值。如果您的扩展程序实现了多个处理脚本，您可以查看 ID 值，了解哪个处理脚本已触发。

details

一个用于描述事件的对象。您可以从此对象的 entries 字段（一个 FileSystemFileEntry 对象数组）中获取用户选择的文件。

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