Obsługa plików w Chrome OS

Obsługa plików pozwala skonfigurować ChromeOS tak, aby rozszerzenie mogło otwierać pliki przy użyciu menu Otwórz w menu pliku lub menu Otwórz za pomocą menu kontekstowego. Po otwarciu przetwarzasz dane pliku za pomocą interfejsu Launch Handler API na platformie internetowej. Następnie nauczysz się korzystać ze standardowych interfejsów API platform internetowych, aby wyświetlić lub przetworzyć plik.

Do menu Otwórz w ChromeOS dodano moduł obsługi plików.

Dostępność w rozszerzeniach

ChromeOS 120 lub nowszym,

Uprawnienia

Do obsługi plików nie są wymagane żadne uprawnienia.

Plik manifestu

Do pliku manifest.json musisz dodać tablicę "file_handlers".

Konteksty pomocnicze

Tego interfejsu API można używać w skryptach service worker rozszerzeń, w wyskakujących okienkach, panelach bocznych i skryptach treści.

Konfigurowanie modułu obsługi plików

Każdy element w elemencie "file_handlers", czyli każdy moduł obsługi plików, określa typ lub typy plików obsługiwane przez stronę konkretnego rozszerzenia.

Określone moduły obsługi zostaną dodane do okna Pliki w ChromeOS, a konkretnie do menu Otwórz i Otwórz za pomocą. Pojawią się w tych menu tylko wtedy, gdy użytkownik wybierze plik z określonym rozszerzeniem. Jeśli na przykład moduł obsługi plików ma wartość .txt, menu ChromeOS będzie wyświetlać ten moduł tylko wtedy, gdy zostanie wybrany plik z tym rozszerzeniem.

Przetwarzanie pliku

Moduł obsługi pliku to plik HTML zawarty w rozszerzeniu. Gdy użytkownik wybierze moduł obsługi z menu, plik HTML otworzy się w nowej karcie. Przetwarzanie pliku bez względu na to, czy go wyświetlasz czy używasz w inny sposób, odbywa się za pomocą JavaScriptu przy użyciu odpowiednich interfejsów API platformy internetowej. Kod przetwarzania musi znajdować się w oddzielnym pliku JavaScript i musi być umieszczony w tagu <script> oraz musi znajdować się w rozszerzeniu. Plik skryptu pobiera obiekt FileSystemFileHandle przez interfejs LaunchQueue interfejsu Launch Handler API.

Przykład

Przykład poniżej pokazuje, jak uzyskać obiekt FileSystemFileHandle za pomocą interfejsu LaunchQueue. Aby zobaczyć, jak wygląda obsługa plików, zainstaluj wersję demonstracyjną obsługi plików.

if ('launchQueue' in window) {
  launchQueue.setConsumer(async launchParams => {
    if (!launchParams.files || !launchParams.files.length) { return; }
    const fileHandle = launchParams.files[0];
  });
}
``````