The FileSystemDirectoryEntry
interface of the File and Directory Entries API represents a directory in a file system. It provides methods which make it possible to access and manipulate the files in a directory, as well as to access the entries within the directory.
FileSystemDirectoryEntry
Basic concepts
You can create a new directory by calling getDirectory()
. If you want to create subdirectories, create each child directory in sequence. If you try creating a directory using a full path that includes parent directories that do not exist yet, an error is returned. So create the hierarchy by recursively adding a new path after creating the parent directory.
Example
In the following code snippet, we create a directory called "Documents."
// Taking care of the browser-specific prefixes. window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem; window.directoryEntry = window.directoryEntry || window.webkitDirectoryEntry; ... function onFs(fs){ fs.root.getDirectory('Documents', {create:true}, function(directoryEntry){ //directoryEntry.isFile === false //directoryEntry.isDirectory === true //directoryEntry.name === 'Documents' //directoryEntry.fullPath === '/Documents' }, onError); } // Opening a file system with temporary storage window.requestFileSystem(TEMPORARY, 1024*1024 /*1MB*/, onFs, onError);
Properties
This interface has no properties of its own, but inherits properties from its parent interface, FileSystemEntry
.
Methods
This interface inherits methods from its parent interface, FileSystemEntry
.
-
createReader()
-
Creates a
FileSystemDirectoryReader
object which can be used to read the entries in this directory. -
getDirectory()
-
Returns a
FileSystemDirectoryEntry
object representing a directory located at a given path, relative to the directory on which the method is called. -
getFile()
-
Returns a
FileSystemFileEntry
object representing a file located within the directory's hierarchy, given a path relative to the directory on which the method is called.
Specifications
Specification |
---|
File and Directory Entries API # api-directoryentry |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
FileSystemDirectoryEntry |
8
|
79
|
50
|
No
|
15
|
11.1
|
≤37
|
18
|
50
|
No
|
11.3
|
1.0
|
createReader |
13
|
79
|
50
|
No
|
No
|
11.1
|
≤37
|
18
|
50
|
No
|
11.3
|
1.0
|
getDirectory |
8
|
79
|
50
|
No
|
No
|
11.1
|
≤37
|
18
|
50
|
No
|
11.3
|
1.0
|
getFile |
8
|
79
|
50
|
No
|
No
|
11.1
|
≤37
|
18
|
50
|
No
|
11.3
|
1.0
|
removeRecursively |
8
|
79
|
50-52
While the
removeRecursively() method existed, it immediately called the error callback with
NS_ERROR_DOM_SECURITY_ERR .
|
No
|
No
|
No
|
≤37
|
18
|
50-52
While the
removeRecursively() method existed, it immediately called the error callback with
NS_ERROR_DOM_SECURITY_ERR .
|
No
|
No
|
1.0
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryEntry