Mit der Dateiverwaltung können Sie ChromeOS so konfigurieren, dass Ihre Erweiterung Dateien entweder über das Menü „Öffnen“ im Dateimenü oder über das Menü „Öffnen mit“ im Kontextmenü öffnen kann. Nach dem Öffnen verarbeiten Sie die Daten der Datei mit der Launch Handler API der Webplattform. Anschließend verwenden Sie Standard-Webplattform-APIs, um die Datei anzuzeigen oder zu verarbeiten.
<ph type="x-smartling-placeholder">![Ein Datei-Handler, der dem ChromeOS-Menü „Öffnen“ hinzugefügt wurde.](https://developer.chrome.com/static/docs/extensions/how-to/web-platform/file-handling-chromeos/image/a-file-handler-added-the-4899ab22819fc.png?authuser=9&hl=de)
Verfügbarkeit in Erweiterungen
ChromeOS 120 oder höher.
Berechtigungen
Für die Dateiverwaltung sind keine Berechtigungen erforderlich.
Manifest
Sie müssen der Datei „manifest.json“ das Array "file_handlers"
hinzufügen.
Unterstützende Kontexte
Diese API kann in Erweiterungs-Service-Workern, Pop-ups, Seitenleisten oder Inhaltsskripten verwendet werden.
Datei-Handler konfigurieren
Jedes Mitglied von "file_handlers"
, also jeder Datei-Handler, gibt einen oder mehrere Dateitypen an, die von einer bestimmten Erweiterungsseite verarbeitet werden sollen.
Die von Ihnen angegebenen Handler werden dem Fenster „ChromeOS-Dateien“, den Menüs „Öffnen“ und „Öffnen mit“, hinzugefügt. Sie werden nur dann in diesen Menüs angezeigt, wenn der Nutzer eine Datei mit der entsprechenden Dateiendung auswählt. Wenn in einem Datei-Handler beispielsweise .txt
angegeben ist, zeigen die ChromeOS-Menüs diesen Handler nur an, wenn eine Datei mit dieser Erweiterung ausgewählt ist.
Datei verarbeiten
Der Datei-Handler ist eine HTML-Datei, die in Ihrer Erweiterung enthalten ist. Wenn der Nutzer Ihren Handler aus einem Menü auswählt, wird die HTML-Datei in einem neuen Tab geöffnet. Die Verarbeitung der Datei, unabhängig davon, ob Sie sie anzeigen oder auf andere Weise verwenden, erfolgt mit JavaScript unter Verwendung geeigneter Webplattform-APIs. Der Verarbeitungscode muss in einer separaten JavaScript-Datei in einem <script>
-Tag und in deiner Erweiterung enthalten sein. Die Skriptdatei verwendet die Schnittstelle LaunchQueue
der Launch Handler API, um ein FileSystemFileHandle
-Objekt abzurufen.
Beispiel
Das folgende Beispiel zeigt, wie ein FileSystemFileHandle
-Objekt mithilfe der LaunchQueue
-Schnittstelle abgerufen wird. Wenn Sie die Dateibehandlung in Aktion sehen möchten, installieren Sie die Demo zur Dateibearbeitung.
if ('launchQueue' in window) {
launchQueue.setConsumer(async launchParams => {
if (!launchParams.files || !launchParams.files.length) { return; }
const fileHandle = launchParams.files[0];
});
}
``````