ContextQMD
Back to Content

FileSystemEntry: isFile property

files/en-us/web/api/filesystementry/isfile/index.md

latest1.4 KB
Original Source

{{APIRef("File and Directory Entries API")}}

The read-only isFile property of the {{domxref("FileSystemEntry")}} interface is true if the entry represents a file (meaning it's a {{domxref("FileSystemFileEntry")}}) and false if it's not.

You can also use {{domxref("FileSystemEntry.isDirectory", "isDirectory")}} to determine if the entry is a directory.

[!WARNING] You should not assume that any entry which isn't a file is a directory or vice versa. There are other types of file descriptors on many operating systems. Be sure to use both isDirectory and isFile as needed to ensure that the entry is something you know how to work with.

Value

A Boolean indicating whether or not the {{domxref("FileSystemEntry")}} is a file.

Examples

This example shows how this property might be used to determine whether to process the entry as a directory or file. If the entry is neither, an error handler is called with an appropriate message.

js
if (entry.isDirectory) {
  processSubdirectory(entry);
} else if (entry.isFile) {
  processFile(entry);
} else {
  displayErrorMessage("Unsupported file system entry specified.");
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also