Skip to Content
Platform.Ontology

File Handling (launchQueue)

Lets an installed web app open files of a given type from the file manager.

Works without askingHome screen and system linksFile typesWeb browsersWhile you use it

In one line

Can open files from your file manager in an installed web app, after you choose it

Lets an installed web app open files of a given type from the file manager.

Registers the PWA as handler for file types; the file arrives as a handle once the person opens it.

What it can and can't do

What the user does: You install the web app, then open a file with Open with and pick it

It can

  • Appear in the Open with list for file types it supports
  • Open the one file you picked and show it in the app
  • Save changes back to that file after you confirm

It cannot

  • Open files you did not choose
  • Work for a site that is not installed
  • Work in Firefox, Safari or on phones
  • Skip the confirm step the first time you open a file

How it differs between platforms: Chrome and Edge on computers only. Phones, Firefox and Safari do not support it.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported1022022-05-24None
EdgeSupported1022022-05-31None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APImanifest file_handlers; window.launchQueue.setConsumer(launchParams => launchParams.files)
Browser compat keysmanifests.webapp.file_handlers
How access is grantedinstall
What the user seesOS Open with list; first open confirm
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets an installed web app open files of a given type from the file manager.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
launchParams.fileslistNoneFileSystemFileHandle[]Not listed

Technical limits

  • Installed PWA only
  • Desktop only (Chrome, Edge)
  • No file type registration on mobile

The story

What it is

An installed web app can be set to open certain file types when you double click them.

For you

You double click a picture or document and it opens in the web app, like a normal desktop program. On first use the browser may ask to confirm. You can change the default later.

For makers

Makers make web apps feel native: their app shows up in Open with and as the default. It deepens habit and loyalty. It works only for installed web apps in Chromium.

Where you see it

TypeExampleApps
creativeA web photo editor opens PNG files straight from your folder when you double click them.None named
musicA web audio editor opens a sound file from the desktop.None named
productivityA web document app opens text and CSV files you double click.Google Docs
developerA web code editor opens source files from the file manager.VS Code for the Web
gamesA web emulator or level editor opens a save or map file with a double click.None named
videoA web video tool opens clips you dragged from a camera folder.None named
educationA web drawing app for classes opens a student's file from a shared drive.None named

Risks

  • Hijacks file defaults
  • Only installed apps

What the platform says

Good uses and abuse

Legitimate uses

  • Editors and viewers

Known abuse

  • None notable

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2022-04, Chrome 102: File Handling ships on desktop

Sources

How well checked: Checked against real behavior.

On this page