Note that archives will also have the isDirectory and isFile properties set. You may both use resolve() to resolve files inside the archive, or open the archive file using open().

Currently only a subset of the ZIP format is currently supported as archives.

This property is used for array style lookup. If the File object is a regular file, its length is 0. Use the fileSize property to get the size of regular files in bytes.

For directories or archives, this property is 0 until refresh() is called, except for mount point File objects that are already loaded.

Anything that occurs after the last '/' in the path of this File. If the file has the path /foo/bar, the name is bar. There is no trailing path separator if this File is a directory.

The full path of this File in the physical file system, including trailing slash or backslash for directories. If you mount a directory c:\foo\ as foo and this directory contains a file bar.txt, the nativePath of this File will be c:\foo\bar.txt. Note that the path separator of the underlying operating system is used in the path.

For the mount points mounted by mountSystemDirectory(), and for all files under them, this property will be empty to avoid exposing system information to the application.

This property is not URL encoded, i.e. it is not modified in any way from how the underlying file system would represent the path.

The full path of this File in the virtual file system, starting with the name of the mount point and including the full file name of this file or directory. There is no trailing path separator if this File is a directory.

Calling this function will copy all the contents of this File to the given target location, given as either a File object or a String containing the path.

If the target location exists, this operation will fail with an exception. Use the overwrite argument to replace existing files in target location.

Supplying the optional callback will make the operation asynchronous, and the function will immediately return a File object representing the copy of the File, regardless of whether the operation is complete. The callback is called when the copy operation is complete, with the copy of the File as an argument. If the operation fails, the callback is called with a null argument.

Create a new directory using either a File object or a URL encoded String with a path to the new directory. All non-existing parent directories are created along with it.

Examples:

file = mountPoint.createDirectory(somePath);
file = mountPoint.createDirectory(mountPoint.resolve(somePath));

If the recursive argument is given as true, this method will attempt to delete the directory and all of its content. If deleting individual files or directories in it fails, the method will continue to delete the rest of the content.

If the entire directory and all of its content is deleted, the method will return true. If parts of the content, and thus also the directory itself could not be deleted, the method will return false.

Calling this function will move all the contents of this File to the given File target location.

If the target location exists, this operation will fail with an exception. Use the overwrite argument to replace existing files in target location.

Supplying the optional callback will make the operation asynchronous, and the function will immediately return a File object representing the new File regardless of whether the operation is complete. The callback is called with the new File as an argument. If the operation fails, the callback is called with a null argument.

If the path argument is given as null, this File will be opened.

The file can be opened in read, write, append or update mode, represented by the constants in opera.io.filemode.

The mode argument is similar to PHPs fopen(), but implemented as constants which can be combined through a bitwise OR, for example as opera.io.filemode.APPEND | opera.io.filemode.READ.

If the file does not exist when opened in WRITE or APPEND mode, it is immediately created. The entire path to the file is created if this does not exist.

If the file does not exist when opened in READ or UPDATE mode, a FILE_NOT_FOUND_ERR is thrown.

The previous version of the API accepted a string equal to the ones described below. This is now deprecated in favor of the constants in opera.io.filemode.

The the following is an extract from http://no2.php.net/fopen and explains possible combinations:

If a file is opened in an invalid mode, for example opening a read-online file in WRITE mode, a SECURITY_ERR is thrown.

'r'

Open for reading only; place the file pointer at the beginning of the file.

'r+'

Open for reading and writing; place the file pointer at the beginning of the file.

'w'

Open for writing only; place the file pointer at the beginning of the file and truncate the file to zero length. If the file does not exist, attempt to create it.

'w+

Open for reading and writing; place the file pointer at the beginning of the file and truncate the file to zero length. If the file does not exist, attempt to create it.

'a'

Open for writing only; place the file pointer at the end of the file. If the file does not exist, attempt to create it.

'a+'

Open for reading and writing; place the file pointer at the end of the file. If the file does not exist, attempt to create it.

Note that opera.io.filemode.UPDATE represents 'r+'.

This function will take a URL encoded String with a path and attempt to resolve the path. If the path is valid, a File object representing it is returned. The File may point to a non-existing file or directory, as long as the path is valid. The resulting File can, for example, be used with the File.createDirectory() method.

If the path is invalid, i.e. pointing to something outside en existing sandbox, an exception is thrown. You may resolve paths with characters that are not recommended and get a File, though exceptions will typically be thrown if you attempt to read from or write to such files.