借助文件处理功能,您可以配置 ChromeOS,以便您的扩展程序使用“文件”菜单的“打开”菜单或上下文菜单的“打开方式”菜单打开文件。打开后,您可以使用网络平台的 Launch Handler API 处理文件的数据。然后,您将使用标准网络平台 API 显示或处理文件。
![添加到 ChromeOS“打开”菜单的文件处理程序。](https://developer.chrome.google.cn/static/docs/extensions/how-to/web-platform/file-handling-chromeos/image/a-file-handler-added-the-4899ab22819fc.png?authuser=8&hl=nb)
在扩展程序中的可用性
ChromeOS 120 或更高版本。
权限
无需任何权限即可处理文件。
清单
您需要向 manifest.json 文件添加 "file_handlers"
数组。
辅助性上下文
此 API 可用于扩展程序 Service Worker、弹出式窗口、侧边栏或内容脚本。
配置文件处理程序
"file_handlers"
的每个成员(即每个文件处理程序)都指定了由特定扩展程序页面处理的一种或多种文件类型。
您指定的处理程序会添加到 ChromeOS 的“文件”窗口(专门针对“打开”和“使用”菜单打开)中。只有在用户选择具有特定扩展名的文件时,这些扩展名才会显示在这些菜单中。例如,如果某个文件处理程序指定了 .txt
,ChromeOS 菜单只会在选中带有该扩展名的文件时显示该处理程序。
处理文件
文件处理程序是包含在扩展程序中的 HTML 文件。当用户从菜单中选择您的处理程序时,HTML 文件会在新标签页中打开。无论是显示文件还是以其他方式使用文件,都是通过 JavaScript 和相应的网络平台 API 完成的。处理代码必须位于单独的 JavaScript 文件中,通过 <script>
标记添加,并且还必须添加到您的扩展程序中。脚本文件使用 Launch Handler API 的 LaunchQueue
接口获取 FileSystemFileHandle
对象。
示例
以下示例演示了如何使用 LaunchQueue
接口获取 FileSystemFileHandle
对象。如需查看文件处理的实际效果,请安装文件处理演示。
if ('launchQueue' in window) {
launchQueue.setConsumer(async launchParams => {
if (!launchParams.files || !launchParams.files.length) { return; }
const fileHandle = launchParams.files[0];
});
}
``````