FileSystemHandle : Object

Instance Properties

kind : String readonly

Will be one of 'directory' or 'file'

Example:

<button onclick="openFile()">Open File</button>
<script>
  const openFile = async () => {
    const [fileHandle] = await showOpenFilePicker();

    console.log(fileHandle.kind);
  };
</script>

Run

Results:

Spec

name : String readonly

Example:

<button onclick="openFile()">Open File</button>
<script>
  const openFile = async () => {
    const [fileHandle] = await showOpenFilePicker();

    console.log(fileHandle.name);
  };
</script>

Run

Results:

Spec

Instance Methods

isSameEntry(other : FileSystemHandle) : Promise<boolean>

Example:

<button onclick="openFile()">Open File</button>
<script>
  const openFile = async () => {
    const [fileHandle1] = await showOpenFilePicker();
    const [fileHandle2] = await showOpenFilePicker();

    console.log(await fileHandle1.isSameEntry(fileHandle2));
  };
</script>

Run

Results:

Spec

queryPermission([descriptor : Object]) : Promise<String>

descriptor : {

mode : String Must be 'read' or 'readwrite'. Default = 'read'.

}

Return value will be one of 'denied', 'granted', or 'prompt'.

Example:

<button onclick="openFile()">Open File</button>
<script>
  const openFile = async () => {
    const [fileHandle] = await showOpenFilePicker();

    console.log(await fileHandle.queryPermission({mode: 'read'}));
    console.log(await fileHandle.queryPermission({mode: 'readwrite'}));
  };
</script>

Run

Results:

Spec

requestPermission([descriptor : Object]) : Promise<String>

descriptor : {

mode : String Must be 'read' or 'readwrite'. Default = 'read'.

}

Return value will be one of 'denied', 'granted', or 'prompt'.

Example:

<button onclick="openFile()">Open File</button>
<script>
  const openFile = async () => {
    const [fileHandle] = await showOpenFilePicker();

    console.log(await fileHandle.requestPermission({mode: 'readwrite'}));
  };
</script>

Run

Results:

Spec

home license contribute feedback toggle light/dark mode