LaunchParams: files property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The files read-only property of the LaunchParams interface returns an array of FileSystemHandle objects representing any files passed along with the launch navigation via the POST method.

Value

A read-only array of FileSystemHandle objects.

Examples

js
if ("launchQueue" in window) {
  window.launchQueue.setConsumer((launchParams) => {
    if (launchParams.files) {
      const files = launchParams.files;
      for (file in files) {
        // Do stuff with file handles
      }
    }
  });
}

Specifications

Specification
Web App Launch Handler API
# ref-for-dom-launchparams-files-1

Browser compatibility

BCD tables only load in the browser

See also