Parse. File

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


new File(name, data, type)

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. 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); {
    // 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.


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.


save(options) → {Promise}

Saves the file to the Parse cloud.

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.
    • progress: In Browser only, callback for upload progress

Promise that is resolved when the save finishes.

url(options) → {String}

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.

Name Type Description
options Object

An object to specify url options