File

Parse. File

A Parse.File is a local representation of a file that is saved to the Parse cloud.

Constructor

new File(name, data, type, metadata, tags)

Parameters:
Name Type Description
name String

The file's name. This will be prefixed by a unique value once the file has finished saving. The file name must begin with an alphanumeric character, and consist of alphanumeric characters, periods, spaces, underscores, or dashes.
data Array

The data for the file, as either: 1. an Array of byte value Numbers, or 2. an Object like { base64: "..." } with a base64-encoded String. 3. an Object like { uri: "..." } with a uri String. 4. a File object selected with a file upload control. (3) only works in Firefox 3.6+, Safari 6.0.2+, Chrome 7+, and IE 10+. For example:

var fileUploadControl = $("#profilePhotoFileUpload")[0];
if (fileUploadControl.files.length > 0) {
  var file = fileUploadControl.files[0];
  var name = "photo.jpg";
  var parseFile = new Parse.File(name, file);
  parseFile.save().then(function() {
    // The file has been saved to Parse.
  }, function(error) {
    // The file either could not be read, or could not be saved to Parse.
  });
}
type String

Optional Content-Type header to use for the file. If this is omitted, the content type will be inferred from the name's extension.
metadata object

Optional key value pairs to be stored with file object
tags object

Optional key value pairs to be stored with file object

Methods

addMetadata(key, value)

Sets metadata to be saved with file object. Adds to existing metadata.

Parameters:
Name Type Description
key string

key to store the metadata
value *

metadata

addTag(key, value)

Sets tags to be saved with file object. Adds to existing tags.

Parameters:
Name Type Description
key string

key to store tags
value *

tag

cancel()

Aborts the request if it has already been sent.

destroy(options) → {Promise}

Deletes the file from the Parse cloud. In Cloud Code and Node only with Master Key.

Parameters:
Name Type Description
options object

Valid options are:

  • useMasterKey: In Cloud Code and Node only, causes the Master Key to be used for this request.
Returns:
Type:
Promise

Promise that is resolved when the delete finishes.

(async) getData() → {Promise}

Return the data for the file, downloading it if not already present. Data is present if initialized with Byte Array, Base64 or Saved with Uri. Data is cleared if saved with File object selected with a file upload control

Returns:
Type:
Promise

Promise that is resolve with base64 data

metadata() → {object}

Gets the metadata of the file.

Returns:
Type:
object

name() → {string}

Gets the name of the file. Before save is called, this is the filename given by the user. After save is called, that name gets prefixed with a unique identifier.

Returns:
Type:
string

save(options) → {Promise|undefined}

Saves the file to the Parse cloud.

Parameters:
Name Type Description
options object

Valid options are:

  • useMasterKey: In Cloud Code and Node only, causes the Master Key to be used for this request.
  • sessionToken: A valid session token, used for making a request on behalf of a specific user.
  • progress: In Browser only, callback for upload progress. For example: 
    let parseFile = new Parse.File(name, file);
parseFile.save({
  progress: (progressValue, loaded, total, { type }) => {
    if (type === "upload" && progressValue !== null) {
      // Update the UI using progressValue
    }
  }
});
Returns:
Type:
Promise | undefined

Promise that is resolved when the save finishes.

setMetadata(metadata)

Sets metadata to be saved with file object. Overwrites existing metadata

Parameters:
Name Type Description
metadata object

Key value pairs to be stored with file object

setTags(tags)

Sets tags to be saved with file object. Overwrites existing tags

Parameters:
Name Type Description
tags object

Key value pairs to be stored with file object

tags() → {object}

Gets the tags of the file.

Returns:
Type:
object

url(options) → {string|undefined}

Gets the url of the file. It is only available after you save the file or after you get the file from a Parse.Object.

Parameters:
Name Type Description
options object

An object to specify url options

Name Type Attributes Description
forceSecure boolean <optional>

force the url to be secure
Returns:
Type:
string | undefined