File editing and management: rich formatting, file storage, drag and drop - HTML5 in Action - page 119

File API 13.0 3.6 N/A 11.1 N/A

Listing 3.12. app.js—Loading files in the File Editor view

Table3.1 reviews the behavior of the File System API method getFile when passed dif-
ferent values of the options object. The object consists of two Boolean fields. The first,
create , determines if getFile should try to create a new FileEntry object (cre-
ate:true) or retrieve an existing FileEntry object (create:false) . The second
field, exclusive , determines if getFile should check for the existence of a FileEntry
object with the same file path name as getFile 's filename argument (exclus-
ive:true) .

Table 3.1. A list of getFile 's responses to various configurations of the options argument [ a ]

a http://www.w3.org/TR/file-system-api/ .

FileEntry state options object getFile response

FileEntry found at given file path name create: false exclusive ignored FileEntry is returned

create: true exclusive: true Error is thrown

FileEntry found at given file path name, but the
FileEntry is a directory

create: false exclusive ignored Error is thrown