Content: Issue with "FileSystemHandle": (short summary here please)

[bboyle]

MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle

What information was incorrect, unhelpful, or incomplete?

I'm confused about FileSystemFileHandle vs FileSystemFileEntry on this page.

Specific section or headline?

• top introduction
• Interfaces based on FileSystemHandle

What did you expect to see?

The API for FileSystemHandle, FileSystemFileHandle and FileSystemDirectoryHandle
I'm not sure if entry interfaces belong here or not. I don't think FileSystemFileEntry inherits from this interface?

Did you test this? If so, how?

I am working with the API today. Chrome tells me that FileSystemFileHandle.file is not a function.

MDN Content page report details

• Folder: en-us/web/api/filesystemhandle
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/filesystemhandle/index.html
• Last commit: https://github.com/mdn/content/commit/f6f11d2a249520f01bad93d7c4a5e5cdf6ed914a
• Document last modified: 2021-02-19T19:33:30.000Z

[Rumyra]

Suffice to say this opening paragraph is confusing - fileSystemHandle provide a handle to a fileSystemEntry. fileSystemFileHandle handles fileSystemFileEntry and fileSystemDirectoryHandle -> fileSystemDirectoryEntry

• Expand on this concept in the opening paragraph
• Modify 'interfaces based on' to link to handles rather than entries (make sure entries are linked to in opening paragraph)
• Might be worth differentiating and linking to https://developer.mozilla.org/en-US/docs/Web/API/File_and_Directory_Entries_API

@wbamberg I wrote this originally so if you have any questions just shout 👍

[bboyle]

thanks for making MDN great! :)