Skip to content

API.md

Latest commit

 

History

History
144 lines (95 loc) · 3.78 KB

API.md

File metadata and controls

144 lines (95 loc) · 3.78 KB

API

Usage

import { transferUtility } from 'react-native-s3';

transferUtility.setupWithNative()

Return: Promise - will resolve arguments:

  • Boolean - true or false depending on the setup successful.

transferUtility.setupWithBasic(options)

  • options Object
    • region String - a S3 Region (default: eu-west-1)
    • access_key String - the AWS access key ID
    • secret_key String - the AWS secret access key
    • session_token String - (optional)

Return: Promise - will resolve arguments:

  • Boolean - true or false depending on the setup successful.

transferUtility.setupWithCognito(options)

  • options Object
    • region String - a S3 Region (default: eu-west-1)
    • identity_pool_id String - the Amazon Cogntio identity pool
    • cognito_region String - a Cognito Region (default: eu-west-1)
    • caching Boolean - use CognitoCachingCredentialsProvider instead of CognitoCredentialsProvider (Android)

See AWS CognitoCredentialsProvider (iOS/Android) for more information.

Return: Promise - will resolve arguments:

  • Boolean - true or false depending on the setup successful.

transferUtility.upload(options)

New a upload task.

  • options Object
    • bucket String - a S3 bucket name
    • key String - the object key/destination in the bucket
    • file String - the file path to upload
    • meta Object
      • contentType String - the file content-type
      • contentMD5 String - the file md5 hash (optional)

Return: Promise - will resolve, see following arguments:

  • Object - a Task object

or reject.

transferUtility.download(options)

New a download task.

  • options Object
    • bucket String - a S3 bucket name
    • key String - the object key/destination in the bucket
    • file String - donwload save file path

Return: Promise - will resolve, see following arguments:

  • Object - a Task object

or reject.

transferUtility.pause(id)

  • id Number - a Task id

transferUtility.resume(id)

  • id Number - a Task id

transferUtility.cancel(id)

  • id Number - a Task id

transferUtility.deleteRecord(id) (Android)

  • id Number - a Task id

Return: Promise - will resolve, see following arguments:

  • Boolean - true or false depending on the delete task record successful.

transferUtility.getTask(id)

Gets a Task object with the given id.

  • id Number - a Task id

Return: Promise - will resolve, see following arguments:

  • Object - a Task object

transferUtility.getTasks(type, idAsKey)

Gets a Task object list with the type.

  • type String - enum: upload, download
  • idAsKey Boolean - true: return Object with id as key, false: return Array

Return: Promise - will resolve, see following arguments:

  • Array - a Task object list

transferUtility.subscribe(id, eventHandler)

Subscribe the task changes with the given id.

  • id Number - a Task id
  • eventHandler Function - arguments:
    • task Object - a Task object

transferUtility.unsubscribe(id)

Unsubscribe the task changes with the given id.

  • id Number - a Task id

The Task object structure

{
  id: Number,
  state: String, // task state
  // progress of task: bytes / totalBytes
  bytes: Number,
  totalBytes: Number,
  bucket: String,
  key: String
}

It will not be immediately refresh, you must subscribe or call getTask(id) to replace it.

The Task states

  • waiting
  • in_progress
  • pause
  • canceled
  • completed
  • failed