The getFile() method of the FileSystemFileHandle interface returns a Promise which resolves to a File object representing the state on disk of the entry represented by the handle.

If the file on disk changes or is removed after this method is called, the returned File object will likely be no longer readable.

None.

A Promise which resolves to a File object.

NotAllowedError DOMException

Thrown if the PermissionStatus.state is not granted in read mode.

The following asynchronous function presents a file picker and once a file is chosen, uses the getFile() method to retrieve the contents.

async function getTheFile() {
  // open file picker
  [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // get file contents
  const fileData = await fileHandle.getFile();
}

• File System API
• The File System Access API: simplifying access to local files