Dateiverarbeitung unter Chrome OS

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>

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