Interfaces

Interface AnimationParams

Hierarchy

  • AnimationParams

Index

Properties

align

Optional

align?: AlignOptions

background

Optional

background?: string

delay

Optional

delay?: number

fit

Optional

fit?: FitOptions

height

Optional

height?: number

loop

Optional

loop?: number

width

Optional

width?: number

Interface AsciiParams

Hierarchy

  • AsciiParams

Index

Properties

background

Optional

background?: string

colored

Optional

colored?: boolean

foreground

Optional

foreground?: string

reverse

Optional

reverse?: boolean

size

Optional

size?: number

Interface BlackwhiteParams

Hierarchy

  • BlackwhiteParams

Index

Properties

threshold

threshold: number

Interface BlurFacesParams

Hierarchy

  • BlurFacesParams

Index

Properties

amount

Optional

amount?: number

blur

Optional

blur?: number

buffer

Optional

buffer?: number

faces

Optional

faces?: string | number

maxsize

Optional

maxsize?: number

minsize

Optional

minsize?: number

type

Optional

type?: ShapeType

Interface BlurParams

Hierarchy

  • BlurParams

Index

Properties

amount

amount: number

Interface BorderParams

Hierarchy

  • BorderParams

Index

Properties

background

Optional

background?: string

color

Optional

color?: string

width

Optional

width?: number

Interface CacheParams

Hierarchy

  • CacheParams

Index

Properties

cache

Optional

cache?: boolean

expiry

expiry: number

Interface CircleParams

Hierarchy

  • CircleParams

Index

Properties

background

Optional

background?: string

Interface ClientOptions

Hierarchy

  • ClientOptions

Indexable

[option: string]: any

Defined in lib/client.ts:52

Index

Properties

cname

Optional

cname?: string

Domain to use for all URLs. Requires the custom CNAME addon. If this is enabled then you must also set up your own OAuth applications for each cloud source you wish to use in the picker.

Defined in lib/client.ts:66

forwardErrors

Optional

forwardErrors?: boolean
Enable forwarding error logs to sentry

Default

false

Defined in lib/client.ts:78

security

Optional

security?: Security

Security object with policy and signature keys. Can be used to limit client capabilities and protect public URLs. It is intended to be used with server-side policy and signature generation. Read about security policies.

Defined in lib/client.ts:60

sessionCache

Optional

sessionCache?: boolean
Enable/disable caching of the cloud session token. Default is false. This ensures that users will be remembered on your domain when calling the cloud API from the browser. Please be aware that tokens stored in localStorage are accessible by other scripts on the same domain.

Defined in lib/client.ts:72

Interface CollageParams

Hierarchy

  • CollageParams

Index

Properties

color

Optional

color?: string

files

files: [string]

fit

Optional

height

Optional

height?: number

margin

Optional

margin?: number

width

Optional

width?: number

Interface CompressParams

Hierarchy

  • CompressParams

Index

Properties

metadata

Optional

metadata?: boolean

Interface CropFacesParams

Hierarchy

  • CropFacesParams

Index

Properties

buffer

Optional

buffer?: number

faces

faces?: string | number

height

Optional

height?: number

mode

Optional

width

Optional

width?: number

Interface CropParams

Hierarchy

  • CropParams

Index

Properties

dim

dim: [number, number, number, number]

Interface DetectFacesParams

Hierarchy

  • DetectFacesParams

Index

Properties

color

Optional

color?: string

export

export?: boolean

maxsize

Optional

maxsize?: number

minsize

Optional

minsize?: number

Interface EnhanceParams

Hierarchy

  • EnhanceParams

Index

Properties

preset

Optional

preset?: EnhancePreset

Interface FallbackParams

Hierarchy

  • FallbackParams

Index

Properties

cache

Optional

cache?: number

handle

Optional

handle: string

Interface FsAuthConfig

Hierarchy

  • FsAuthConfig

Index

Properties

password

password: string

username

username: string

Interface FsRequestHeaders

Hierarchy

  • FsRequestHeaders

Indexable

[name: string]: string

Interface FsRequestOptions

Hierarchy

  • FsRequestOptions

Index

Properties

auth

Optional

blobResponse

Optional

blobResponse?: boolean

cache

Optional

cache?: RequestCache

cancelToken

Optional

cancelToken?: FsCancelToken

data

Optional

data?: any

filestackHeaders

Optional

filestackHeaders?: boolean

headers

Optional

method

Optional

method?: FsHttpMethod

mode

Optional

mode?: RequestMode

onProgress

Optional

onProgress?: ((pr: ProgressEvent<EventTarget>) => any)

Type declaration

  • (pr: ProgressEvent<EventTarget>): any

Parameters

  • pr: ProgressEvent<EventTarget>

Returns any

params

Optional

redirect

Optional

redirect?: RequestRedirect

retry

Optional

runtime

Optional

timeout

Optional

timeout?: number

url

Optional

url?: string

Interface FsRequestParams

Hierarchy

  • FsRequestParams

Indexable

[name: string]: string | number

Interface FsRequestRuntime

Hierarchy

  • FsRequestRuntime

Indexable

[name: string]: any

Index

Properties

retryCount

Optional

retryCount?: number

Interface FsResponse

Hierarchy

  • FsResponse

Index

Properties

config

data

data: any

headers

headers: any

status

status: number

statusText

statusText: string

Interface FsRetryConfig

Hierarchy

  • FsRetryConfig

Index

Properties

onRetry

Optional

onRetry?: ((requestConfig: any) => void)

Type declaration

  • (requestConfig: any): void

Parameters

  • requestConfig: any

Returns void

retry

retry: number

retryFactor

Optional

retryFactor?: number

retryMaxTime

Optional

retryMaxTime?: number

Interface MetadataOptions

Hierarchy

  • MetadataOptions

Index

Properties

cloud

Optional

cloud?: boolean

container

Optional

container?: boolean

exif

Optional

exif?: boolean

filename

Optional

filename?: boolean

height

Optional

height?: boolean

location

Optional

location?: boolean

md5

Optional

md5?: boolean

mimetype

Optional

mimetype?: boolean

path

Optional

path?: boolean

sha1

Optional

sha1?: boolean

sha224

Optional

sha224?: boolean

sha256

Optional

sha256?: boolean

sha384

Optional

sha384?: boolean

sha512

Optional

sha512?: boolean

size

Optional

size?: boolean

sourceUrl

Optional

sourceUrl?: boolean

uploaded

Optional

uploaded?: boolean

width

Optional

width?: boolean

writeable

Optional

writeable?: boolean

Interface MinifyCssParams

Hierarchy

  • MinifyCssParams

Index

Properties

gzip

Optional

gzip?: boolean

level

Optional

level?: number

Interface MinifyJsParams

Hierarchy

  • MinifyJsParams

Index

Properties

gzip

Optional

gzip?: boolean

keep_class_name

Optional

keep_class_name?: boolean

keep_fn_name

Optional

keep_fn_name?: boolean

mangle

Optional

mangle?: boolean

merge_vars

Optional

merge_vars?: boolean

remove_console

Optional

remove_console?: boolean

remove_undefined

Optional

remove_undefined?: boolean

targets

Optional

targets?: string

use_babel_polyfill

Optional

use_babel_polyfill?: boolean

Interface ModulateParams

Hierarchy

  • ModulateParams

Index

Properties

brightness

Optional

brightness?: number

hue

Optional

hue?: number

saturation

Optional

saturation?: number

Interface OilPaintParams

Hierarchy

  • OilPaintParams

Index

Properties

amount

Optional

amount: number

Interface OutputParams

Hierarchy

  • OutputParams

Index

Properties

background

Optional

background?: string

colorspace

Optional

colorspace?: string

compress

Optional

compress?: boolean

density

Optional

density?: number

docinfo

Optional

docinfo?: boolean

format

format: string

page

Optional

page?: number

pageformat

Optional

pageformat?: string

pageorientation

Optional

pageorientation?: string

quality

Optional

quality?: number

secure

Optional

secure?: boolean

strip

Optional

strip?: boolean

Interface PartialBlurParams

Hierarchy

  • PartialBlurParams

Index

Properties

amount

amount: number

blur

Optional

blur?: number

objects

Optional

objects?: [[number, number, number, number]]

type

Optional

type?: ShapeType

Interface PartialPixelateParams

Hierarchy

  • PartialPixelateParams

Index

Properties

amount

Optional

amount?: number

blur

Optional

blur?: number

objects

Optional

objects?: [[number, number, number, number]]

type

Optional

type?: ShapeType

Interface PdfConvertParams

Hierarchy

  • PdfConvertParams

Index

Properties

pageformat

Optional

pageformat?: string

pageorientation

Optional

pageorientation?: string

pages

Optional

pages?: (string | number)[]

Interface PdfInfoParams

Hierarchy

  • PdfInfoParams

Index

Properties

colorinfo

Optional

colorinfo?: boolean

Interface PickerFileMetadata

Hierarchy

  • PickerFileMetadata

Index

Properties

alt

alt: string
Alt text for images

container

Optional

container?: string
The cloud container for the uploaded file.

cropped

Optional

cropped?: PickerCroppedData
Position and size information for cropped images.

filename

filename: string
Name of the file.

handle

handle: string
Filestack handle for the uploaded file.

key

Optional

key?: string
The hash-prefixed cloud storage path.

mimetype

mimetype: string
The MIME type of the file.

originalFile

Optional

originalFile?: object | File
Properties of the local binary file. Also see the pick option exposeOriginalFile if you want the underlying File object.

originalPath

originalPath: string
The origin of the file, e.g. /Folder/file.jpg.

rotated

Optional

rotated?: PickerRotatedData
Direction and value information for rotated images.

size

size: number
Size in bytes of the uploaded file.

source

source: string
The source from where the file was picked.

status

Optional

status?: string
Indicates Filestack transit status.

uploadId

uploadId: string
A uuid for tracking this file in callbacks.

url

url: string
The Filestack CDN URL for the uploaded file.

Interface PickerInstance

Hierarchy

  • PickerInstance

Defined in lib/picker.ts:24

Index

Properties

cancel

cancel: (() => Promise<void>)

Type declaration

  • (): Promise<void>
    Cancel picker uploads. This operation is idempotent.

Returns Promise<void>

Defined in lib/picker.ts:33

close

close: (() => Promise<void>)

Type declaration

  • (): Promise<void>
    Close picker. This operation is idempotent.
Returns Promise<void>

Defined in lib/picker.ts:28

crop

crop: ((files: any[]) => Promise<void>)

Type declaration

  • (files: any[]): Promise<void>
    Specify a list of files to open in the picker for cropping
Example
// <input id="fileSelect" type="file">

const inputEl = document.getElementById('fileSelect');
const picker = client.picker({
  onUploadDone: res => console.log(res),
});

inputEl.addEventListener('change', (e) => {
  picker.crop(e.target.files);
});

// Or pass an array of URL strings
const urls = [
  'https://d1wtqaffaaj63z.cloudfront.net/images/fox_in_forest1.jpg',
  'https://d1wtqaffaaj63z.cloudfront.net/images/sail.jpg',
];
picker.crop(urls);
Parameters
  • files: any[]

Returns Promise<void>

Defined in lib/picker.ts:65

open

open: (() => Promise<void>)

Type declaration

  • (): Promise<void>
    Open picker. This operation is idempotent.

Returns Promise<void>

Defined in lib/picker.ts:38

Interface PickerOptions

Hierarchy

  • PickerOptions

Index

Properties

accept

Optional

accept?: string | string[]
Restrict file types that are allowed to be picked. Formats accepted:
  • .pdf <- any file extension
  • image/jpeg <- any mime type commonly known by browsers
  • image/* <- accept all types of images
  • video/* <- accept all types of video files
  • audio/* <- accept all types of audio files
  • application/* <- accept all types of application files
  • text/* <- accept all types of text files

acceptFn

Optional

acceptFn?: ((PickerFileMetadata: any, PickerAcceptFnOptions: any) => Promise<string>)

Type declaration

  • (PickerFileMetadata: any, PickerAcceptFnOptions: any): Promise<string>
    Custom accept check function
acceptFn: (file, options) => {
  return options.mimeFromMagicBytes(file.originalFile).then((res) => { // we can check mimetype from magic bytes
    //console.log(options.mimeFromExtension(file.originalFile.name)); // or check extension from filestack extensions database
    // throw new Error('Cannot accept that file') // we can throw exception to block file upload
    // return Promise.reject('Cannot accept that file'') // or reject a promise
    return Promise.resolve();
  });
}
Parameters
  • PickerFileMetadata: any
  • PickerAcceptFnOptions: any
Returns Promise<string>

allowManualRetry

Optional

allowManualRetry?: boolean
Prevent modal close on upload failure and allow users to retry.

cleanupImageExif

Optional

cleanupImageExif?: boolean | {
    keepICCandAPP?: boolean;
    keepOrientation?: boolean;
}
Turn on cleaning JPEG image exif. Method can keep image orientation or color profiles
cleanupImageExif: {
  keepOrientation: true,
  keepICCandAPP: true
}

concurrency

Optional

concurrency?: number
Max number of files to upload concurrently. Default is 4.

container

Optional

container?: string | Node

Container where picker should be appended. Only relevant for inline and dropPane display modes.

customAuthText

Optional

customAuthText?: CustomAuthTextOptions

Customize the text on the cloud authentication screen in Picker. Use a cloud source name (see fromSources) or a ‘default’ as a key, then put your custom notice or consent to the ‘top’ or the ‘bottom’ key to show it respectivly above or under ‘Connect button’.

customAuthText: {
  // use it for every cloud authentication screen
  default: {
    top: [
      'default top first line',
      'default top second line'
    ],
    bottom: [
      'default bottom first line',
      'default bottom second line'
    ]
  },
  // override a default bottom text for only gmail
  gmail: {
    bottom: [
      'We need your permission to access your data and',
      'process it with our machine learning system.'
    ]
  }
}

customSourceContainer

Optional

customSourceContainer?: string
Set the default container for your custom source.

customSourceName

Optional

customSourceName?: string
Set the display name for the custom source.

customSourcePath

Optional

customSourcePath?: string
Set the default path for your custom source container.

customText

Optional

customText?: PickerCustomText

Provide an object for mapping picker strings to your own strings. Strings surrounded by brackets, { foobar }, are interpolated with runtime values. Source labels are also available to override, e.g. Facebook, Instagram, Dropbox, etc.

disableAltText

Optional

disableAltText?: boolean
Disables alt text view/edit in the summary screen.

disableDirectoryUpload

Optional

disableDirectoryUpload?: boolean
Disable/Enable possibility to upload directories.

disableStorageKey

Optional

disableStorageKey?: boolean
When true removes the hash prefix on stored files.

disableThumbnails

Optional

disableThumbnails?: boolean
Disables local image thumbnail previews in the summary screen.

disableTransformer

Optional

disableTransformer?: boolean
When true removes ability to edit images.

displayMode

Optional

displayMode?: PickerDisplayMode

Picker display mode, one of 'inline', 'overlay', 'dropPane' – default is 'overlay'.

dropPane

Optional

dropPane?: PickerDropPaneOptions

Configure the drop pane behavior, i.e. when displayMode is dropPane.

errorsTimeout

Optional

errorsTimeout?: number
Timeout for error messages

exposeOriginalFile

Optional

exposeOriginalFile?: boolean

When true the originalFile metadata will be the actual File object instead of a POJO

fromSources

Optional

fromSources?: string[]

Valid sources are:

  • local_file_system – Default
  • url – Default
  • imagesearch – Default
  • facebook – Default
  • instagram – Default
  • googledrive – Default
  • dropbox – Default
  • webcam – Uses device menu on mobile. Not currently supported in Safari and IE.
  • video – Uses device menu on mobile. Not currently supported in Safari and IE.
  • audio – Uses device menu on mobile. Not currently supported in Safari and IE.
  • box
  • github
  • gmail
  • googlephotos
  • onedrive
  • onedriveforbusiness
  • customsource – Configure this in your Filestack Dev Portal.
  • unsplash

globalDropZone

Optional

globalDropZone?: boolean
Toggle the drop zone to be active on all views. Default is active only on local file source.

hideModalWhenUploading

Optional

hideModalWhenUploading?: boolean

Hide the picker modal UI once uploading begins. Defaults to false.

imageDim

Optional

imageDim?: [number, number]
Specify image dimensions. e.g. [800, 600]. Only for JPEG, PNG, and BMP files. Local and cropped images will be resized (upscaled or downscaled) to the specified dimensions before uploading. The original height to width ratio is maintained. To resize all images based on the width, set [width, null], e.g. [800, null]. For the height set [null, height], e.g. [null, 600].

imageMax

Optional

imageMax?: [number, number]

Specify maximum image dimensions. e.g. [800, 600]. Only for JPEG, PNG, and BMP files. Images bigger than the specified dimensions will be resized to the maximum size while maintaining the original aspect ratio. The output will not be exactly 800×600 unless the imageMax matches the aspect ratio of the original image.

imageMin

Optional

imageMin?: [number, number]

Specify minimum image dimensions. e.g. [800, 600]. Only for JPEG, PNG, and BMP files. Images smaller than the specified dimensions will be upscaled to the minimum size while maintaining the original aspect ratio. The output will not be exactly 800×600 unless the imageMin matches the aspect ratio of the original image.

lang

Optional

lang?: string

Sets locale. Accepts: ca, da, de, en, es, fr, he, it, ja, ko, nl, no, pl, pt, sv, ru, vi, zh, tr

maxFiles

Optional

maxFiles?: number

Maximum number of files allowed to upload. Defaults to 1.

maxSize

Optional

maxSize?: number

Restrict selected files to a maximum number of bytes. (e.g. 10 * 1024 * 1024 for 10MB limit).

minFiles

Optional

minFiles?: number

Minimum number of files required to start uploading. Defaults to 1.

miniUploader

Optional

miniUploader?: boolean
Enable/Disable Mini Uploader

modalSize

Optional

modalSize?: [number, number]
Specify [width, height] in pixels of the desktop modal.

multipleFileUpload

Optional

multipleFileUpload?: boolean

Enable/Disable possibility to multiple file upload

onCancel

Optional

Called when all uploads in a pick are cancelled.

onClose

Optional

onClose?: (() => void)

Type declaration

  • (): void
    Called when the UI is exited.

Returns void

onFileCropped

Optional

onFileCropped?: PickerFileCallback
Called when file is cropped in picker

onFileSelected

Optional

onFileSelected?: PickerFileCallback
Called whenever user selects a file.

Example

// Using to veto file selection
// If you throw any error in this function it will reject the file selection.
// The error message will be displayed to the user as an alert.
onFileSelected(file) {
  if (file.size > 1000 * 1000) {
    throw new Error('File too big, select something smaller than 1MB');
  }
}

// Using to change selected file name
// NOTE: This currently only works for local uploads
onFileSelected(file) {
  // It's important to return a new file by the end of this function.
  return { ...file, name: 'foo' };
}

The callback function can also return a Promise to allow asynchronous validation logic. You can pass a file object to resolve for changing the file name, it will behave the same as when the file is returned from the non-async callback.

onFileSelected(file) {
  return new Promise((resolve, reject) => {
    // Do something async
    resolve();
    // Or reject the selection with reject()
  });
}

onFileUploadCancel

Optional

onFileUploadCancel?: PickerFileCancelCallback
Called when a file upload has been canceled.

onFileUploadFailed

Optional

onFileUploadFailed?: PickerFileErrorCallback
Called when uploading a file fails.

onFileUploadFinished

Optional

onFileUploadFinished?: PickerFileCallback
Called when a file is done uploading.

onFileUploadProgress

Optional

onFileUploadProgress?: PickerFileProgressCallback
Called during multi-part upload progress events. Local files only.

onFileUploadStarted

Optional

onFileUploadStarted?: PickerFileWithTokenCallback
Called when a file begins uploading.

onOpen

Optional

onOpen?: ((handle: PickerInstance) => void)

Type declaration

Parameters

Returns void

onUploadDone

Optional

Called when all files have been uploaded.

onUploadStarted

Optional

onUploadStarted?: PickerUploadStartedCallback
Called when uploading starts (user initiates uploading).

pasteMode

Optional

pasteMode?: {
    pasteToFirstInViewPort?: boolean;
    pasteToFirstInstance?: boolean;
}
Specify which Picker instance should respond to paste event. By default only hovered instance responds to event.

Param

If none instance is hovered take first picker instance fully visible in viewport

Param

If none instance is hovered take first picker instance that is initialized

Paste To First In View Port

is checked first

Type declaration

  • Optional pasteToFirstInViewPort?: boolean
  • Optional pasteToFirstInstance?: boolean

rootId

Optional

rootId?: string
Define a unique id for the application mount point. May be useful for more advanced use cases. For example, if you wish to have more than one picker instance open at once, then each will need their own unique rootId.

Note: This option is ignored when displayMode is dropPane.

startUploadingWhenMaxFilesReached

Optional

startUploadingWhenMaxFilesReached?: boolean

Whether to start uploading automatically when maxFiles is hit. Defaults to false.

storeTo

Optional

storeTo?: PickerStoreOptions
Options for file storage.

supportEmail

Optional

supportEmail?: string
set support email to display in case of error

transformations

Optional

transformations?: PickerTransformationOptions
Specify options for images passed to the crop UI.

transformationsUI

Optional

transformationsUI?: boolean

Whether to use the new transformations UI. Defaults to false.

uploadConfig

Optional

uploadConfig?: UploadOptions
Options for local file uploads.

uploadInBackground

Optional

uploadInBackground?: boolean

Start uploading immediately on file selection. Defaults to true.

Important

The feature is can be enabled only if crop is disabled – disableTransformer: true

useSentryBreadcrumbs

Optional

useSentryBreadcrumbs?: boolean

Use Sentry Breadcrumbs mechanism to log information about occured errors. It can override global objects like console, error etc. Defaults to true.

videoResolution

Optional

videoResolution?: string

Sets the resolution of recorded video. One of “320×240”, “640×480” or “1280×720”. Default is "640x480".

viewType

Optional

viewType?: "list" | "grid"
Default view type option for file browser

websearch

Optional

websearch?: object
Provide default text value for Image Search
websearch: {
  predefinedText: 'Sample text'
}

Interface PickerResponse

Hierarchy

  • PickerResponse

Index

Properties

filesFailed

filesFailed: PickerFileMetadata[]

filesUploaded

filesUploaded: PickerFileMetadata[]

Interface PickerUploadDoneCallback

Hierarchy

  • PickerUploadDoneCallback
PickerUploadDoneCallback(files: PickerResponse): void

Parameters

Returns void

Interface PixelateFacesParams

Hierarchy

  • PixelateFacesParams

Index

Properties

amount

Optional

amount?: number

blur

Optional

blur?: number

buffer

Optional

buffer?: number

faces

Optional

faces?: string | number

maxsize

Optional

maxsize?: number

minsize

Optional

minsize?: number

type

Optional

type?: ShapeType

Interface PixelateParams

Hierarchy

  • PixelateParams

Index

Properties

amount

amount: number

Interface PolaroidParams

Hierarchy

  • PolaroidParams

Index

Properties

background

Optional

background?: string

color

Optional

color?: string

rotate

Optional

rotate?: number

Interface PreviewOptions

Hierarchy

  • PreviewOptions

Index

Properties

css

Optional

css?: string
URL to custom CSS

id

id: string
Id for DOM element to embed preview into. Omit this to open the preview in a new tab

Interface ProgressiveJpgParams

Hierarchy

  • ProgressiveJpgParams

Index

Properties

metadata

metadata: boolean

quality

quality: number

Interface QualityParams

Hierarchy

  • QualityParams

Index

Properties

value

value: number

Interface ResizeParams

Hierarchy

  • ResizeParams

Index

Properties

align

Optional

align?: AlignOptions

fit

Optional

height

Optional

height?: number

width

Optional

width?: number

Interface RetrieveOptions

Hierarchy

  • RetrieveOptions

Index

Properties

cache

Optional

cache?: boolean

dl

Optional

dl?: boolean

extension

Optional

extension?: string

head

Optional

head?: boolean

metadata

Optional

metadata?: boolean

Interface RotateParams

Hierarchy

  • RotateParams

Index

Properties

background

Optional

background?: string

color

Optional

color?: string

deg

deg: string | number

Interface RoundedCornersParams

Hierarchy

  • RoundedCornersParams

Index

Properties

background

Optional

background?: string

blur

Optional

blur?: number

radius

Optional

radius?: number

Interface Security

Hierarchy

  • Security

Defined in lib/client.ts:47

Index

Properties

policy

policy: string

Defined in lib/client.ts:48

signature

signature: string

Defined in lib/client.ts:49

Interface SecurityOptions

Configures a security policy

See

Hierarchy

  • SecurityOptions

Index

Properties

call

Optional

call?: any[]

container

Optional

container?: string

expiry

expiry: number

handle

Optional

handle?: string

maxSize

Optional

maxSize?: number

minSize

Optional

minSize?: number

path

Optional

path?: string

url

Optional

url?: string

Interface SecurityParams

Hierarchy

  • SecurityParams

Index

Properties

policy

policy: string

signature

Optional

signature?: string

Interface SepiaParams

Hierarchy

  • SepiaParams

Index

Properties

tone

tone: number

Interface ShadowParams

Hierarchy

  • ShadowParams

Index

Properties

background

Optional

background?: string

blur

Optional

blur?: number

color

Optional

color?: string

opacity

Optional

opacity?: number

vector

Optional

vector?: [number, number]

Interface SharpenParams

Hierarchy

  • SharpenParams

Index

Properties

amount

amount: number

Interface SmartCropParams

Hierarchy

  • SmartCropParams

Index

Properties

height

height: number

mode

width

width: number

Interface StoreBaseParams

Hierarchy

  • StoreBaseParams

Index

Properties

access

Optional

access?: string

container

Optional

container?: string

disableStorageKey

Optional

disableStorageKey?: boolean

location

Optional

location?: string

path

Optional

path?: string

region

Optional

region?: string

Interface TornEdgesParams

Hierarchy

  • TornEdgesParams

Index

Properties

background

Optional

background?: string

spread

Optional

spread?: [number, number]

Interface TransformOptions

See

Hierarchy

  • TransformOptions

Index

Properties

ascii

Optional

ascii?: true | {
    background?: string;
    colored?: boolean;
    foreground?: string;
    reverse?: boolean;
    size?: number;
}

blackwhite

Optional

blackwhite?: true | {
    threshold: number;
}

blur

Optional

blur?: true | {
    amount: number;
}

blur_faces

Optional

blur_faces?: {
    amount?: number;
    blur?: number;
    buffer?: number;
    faces?: string | number;
    maxsize?: number;
    minsize?: number;
    type?: EShapeType;
}

Type declaration

  • Optional amount?: number
  • Optional blur?: number
  • Optional buffer?: number
  • Optional faces?: string | number
  • Optional maxsize?: number
  • Optional minsize?: number
  • Optional type?: EShapeType

border

Optional

border?: true | {
    background?: string;
    color?: string;
    width?: number;
}

cache

Optional

cache?: {
    cache?: boolean;
    expiry: number;
}

Type declaration

  • Optional cache?: boolean
  • expiry: number

circle

Optional

circle?: true | {
    background?: string;
}

collage

Optional

collage?: {
    color?: string;
    files: [string];
    fit?: EFitOptions;
    height?: number;
    margin?: number;
    width?: number;
}

Type declaration

  • Optional color?: string
  • files: [string]
  • Optional fit?: EFitOptions
  • Optional height?: number
  • Optional margin?: number
  • Optional width?: number

compress

Optional

compress?: boolean

crop

Optional

crop?: {
    dim: [number, number, number, number];
}

Type declaration

  • dim: [number, number, number, number]

crop_faces

Optional

crop_faces?: {
    buffer?: number;
    faces?: string | number;
    height?: number;
    mode?: ECropfacesType;
    width?: number;
}

Type declaration

  • Optional buffer?: number
  • Optional faces?: string | number
  • Optional height?: number
  • Optional mode?: ECropfacesType
  • Optional width?: number

detect_faces

Optional

detect_faces?: true | {
    color?: string;
    export?: boolean;
    maxsize?: number;
    minsize?: number;
}

enchance

Optional

enchance?: boolean

flip

Optional

flip?: boolean

flop

Optional

flop?: boolean

imagesize

Optional

imagesize?: boolean

modulate

Optional

modulate?: true | {
    brightness?: number;
    hue?: number;
    saturation?: number;
}

monochrome

Optional

monochrome?: boolean

negative

Optional

negative?: boolean

no_metadata

Optional

no_metadata?: boolean

oil_paint

Optional

oil_paint?: true | {
    amount: number;
}

output

Optional

output?: {
    background?: string;
    colorspace?: string;
    compress?: boolean;
    density?: number;
    docinfo?: boolean;
    format: string;
    page?: number;
    pageformat?: string;
    pageorientation?: string;
    quality?: number;
    secure?: boolean;
    strip?: boolean;
}

Type declaration

  • Optional background?: string
  • Optional colorspace?: string
  • Optional compress?: boolean
  • Optional density?: number
  • Optional docinfo?: boolean
  • format: string
  • Optional page?: number
  • Optional pageformat?: string
  • Optional pageorientation?: string
  • Optional quality?: number
  • Optional secure?: boolean
  • Optional strip?: boolean

partial_blur

Optional

partial_blur?: {
    amount: number;
    blur?: number;
    objects?: [[number, number, number, number]];
    type?: EShapeType;
}

Type declaration

  • amount: number
  • Optional blur?: number
  • Optional objects?: [[number, number, number, number]]
  • Optional type?: EShapeType

partial_pixelate

Optional

partial_pixelate?: {
    amount?: number;
    blur?: number;
    objects?: [[number, number, number, number]];
    type?: EShapeType;
}

Type declaration

  • Optional amount: number
  • Optional blur?: number
  • Optional objects?: [[number, number, number, number]]
  • Optional type?: EShapeType

pdfconvert

Optional

pdfconvert?: {
    pageformat?: string;
    pageorientation?: string;
    pages?: (string | number)[];
}

Type declaration

  • Optional pageformat?: string
  • Optional pageorientation?: string
  • Optional pages?: (string | number)[]

pdfinfo

Optional

pdfinfo?: true | {
    colorinfo?: boolean;
}

pixelate

Optional

pixelate?: true | {
    amount: number;
}

pixelate_faces

Optional

pixelate_faces?: {
    amount?: number;
    blur?: number;
    buffer?: number;
    faces?: string | number;
    maxsize?: number;
    minsize?: number;
    type?: EShapeType;
}

Type declaration

  • Optional amount?: number
  • Optional blur?: number
  • Optional buffer?: number
  • Optional faces?: string | number
  • Optional maxsize?: number
  • Optional minsize?: number
  • Optional type?: EShapeType

pjpg

Optional

pjpg?: {
    metadata: boolean;
    quality: number;
}

Type declaration

  • metadata: boolean
  • quality: number

polaroid

Optional

polaroid?: true | {
    background?: string;
    color?: string;
    rotate?: number;
}

quality

Optional

quality?: {
    value: number;
}

Type declaration

  • value: number

redeye

Optional

redeye?: boolean

resize

Optional

resize?: {
    align?: EAlignFacesOptions;
    fit?: EFitOptions;
    height?: number;
    width?: number;
}

Type declaration

rotate

Optional

rotate?: {
    background?: string;
    color?: string;
    deg: string | number;
}

Type declaration

  • Optional background?: string
  • Optional color?: string
  • deg: string | number

rounded_corners

Optional

rounded_corners?: true | {
    background?: string;
    blur?: number;
    radius?: number;
}

security

Optional

security?: {
    policy: string;
    signature?: string;
}

Type declaration

  • policy: string
  • Optional signature?: string

sepia

Optional

sepia?: true | {
    tone: number;
}

sfw

Optional

sfw?: boolean

shadow

Optional

shadow?: true | {
    background?: string;
    blur?: number;
    color?: string;
    opacity?: number;
    vector?: [number, number];
}

sharpen

Optional

sharpen?: true | {
    amount: number;
}

smart_crop

Optional

smart_crop?: {
    height: number;
    mode?: ESmartCropMode;
    width: number;
}

Type declaration

store

Optional

store?: {
    access?: string;
    base64decode?: boolean;
    container?: string;
    filename?: string;
    location?: string;
    path?: string;
    region?: string;
}

Type declaration

  • Optional access?: string
  • Optional base64decode?: boolean
  • Optional container?: string
  • Optional filename?: string
  • Optional location?: string
  • Optional path?: string
  • Optional region?: string

tags

Optional

tags?: boolean

torn_edges

Optional

torn_edges?: true | {
    background?: string;
    spread?: [number, number];
}

upscale

Optional

upscale?: true | {
    noise?: ENoiseType;
    style?: EStyleType;
    upscale?: boolean;
}

urlscreenshot

Optional

urlscreenshot?: true | {
    agent?: EUrlscreenshotAgent;
    delay?: number;
    device?: string;
    height?: number;
    mode?: EUrlscreenshotMode;
    orientation?: EUrlscreenshotOrientation;
    width?: number;
}

video_convert

Optional

video_convert?: {
    access?: EVideoAccess;
    aspect_mode: EVideoAccessMode;
    audio_bitrate?: number;
    audio_channels?: number;
    audio_codec?: EAudioTypes;
    audio_sample_rate?: number;
    clip_length?: string;
    clip_offset?: string;
    container?: string;
    extname?: string;
    filename?: string;
    force?: boolean;
    fps?: number;
    height?: number;
    keyframe_interval?: number;
    location?: EVideoLocations;
    path?: string;
    preset?: EVideoTypes;
    title?: string;
    two_pass?: boolean;
    upscale: boolean;
    video_bitrate?: number;
    watermark_bottom?: number;
    watermark_height?: number;
    watermark_left?: number;
    watermark_right?: number;
    watermark_top?: number;
    watermark_url?: string;
    watermark_width?: number;
    width?: number;
}

Type declaration

  • Optional access?: EVideoAccess
  • aspect_mode: EVideoAccessMode
  • Optional audio_bitrate?: number
  • Optional audio_channels?: number
  • Optional audio_codec?: EAudioTypes
  • Optional audio_sample_rate?: number
  • Optional clip_length?: string
  • Optional clip_offset?: string
  • Optional container?: string
  • Optional extname?: string
  • Optional filename?: string
  • Optional force?: boolean
  • Optional fps?: number
  • Optional height?: number
  • Optional keyframe_interval?: number
  • Optional location?: EVideoLocations
  • Optional path?: string
  • Optional preset?: EVideoTypes
  • Optional title?: string
  • Optional two_pass?: boolean
  • upscale: boolean
  • Optional video_bitrate?: number
  • Optional watermark_bottom?: number
  • Optional watermark_height?: number
  • Optional watermark_left?: number
  • Optional watermark_right?: number
  • Optional watermark_top?: number
  • Optional watermark_url?: string
  • Optional watermark_width?: number
  • Optional width?: number

vignette

Optional

vignette?: {
    amount?: number;
    background?: string;
    blurmode?: EBlurMode;
}

Type declaration

  • Optional amount?: number
  • Optional background?: string
  • Optional blurmode?: EBlurMode

watermark

Optional

watermark?: {
    files: string;
    position?: EImageWatermarkPosition | EImageWatermarkPosition[];
    size?: number;
}

Type declaration

Interface URLScreenshotParams

Hierarchy

  • URLScreenshotParams

Index

Properties

agent

Optional

delay

Optional

delay?: number

device

Optional

device?: string

height

Optional

height?: number

mode

Optional

orientation

Optional

width

Optional

width?: number

Interface UploadOptions

Hierarchy

  • UploadOptions

Index

Properties

altText

Optional

altText?: string

concurrency

Optional

concurrency?: number

device

Optional

device?: string
Maximum amount of part jobs to run concurrently. Default is 3.

disableIntegrityCheck

Optional

disableIntegrityCheck?: boolean
Disable checking integrity of uploaded files. On slower devices it can boost upload performance (disable counting md5 from file parts)

intelligent

Optional

intelligent?: boolean | "fallback"

Enable/disable intelligent ingestion. If truthy then intelligent ingestion must be enabled in your Filestack application. Passing true/false toggles the global intelligent flow (all parts are chunked and committed). Passing 'fallback' will only use FII when network conditions may require it (only failing parts will be chunked).

intelligentChunkSize

Optional

intelligentChunkSize?: number
Set the default intiial chunk size for Intelligent Ingestion. Defaults to 8MB on desktop and 1MB on mobile.

onProgress

Optional

onProgress?: ((evt: FSProgressEvent) => void)

Type declaration

  • (evt: FSProgressEvent): void
    Callback for progress events.
Parameters
  • evt: FSProgressEvent

Returns void

onRetry

Optional

onRetry?: (() => void)

Type declaration

  • (): void
    Callback for retry events.

Returns void

partSize

Optional

partSize?: number

Maximum size for file slices. Is overridden when intelligent=true. Default is 6 * 1024 * 1024 (6MB).

progressInterval

Optional

progressInterval?: number
How often to report progress. Default is 1000 (in milliseconds).

retry

Optional

retry?: number
Retry limit. Default is 10.

retryFactor

Optional

retryFactor?: number
Factor for exponential backoff on server errors. Default is 2.

retryMaxTime

Optional

retryMaxTime?: number
Upper bound for exponential backoff. Default is 15000.

tags

Optional

tags?: UploadTags
Define upload tags to be passed to webhook

Memberof

UploadOptions

timeout

Optional

timeout?: number
Timeout for network requests. Default is 120000.

Interface UploadTags

Hierarchy

  • UploadTags

Indexable

[key: string]: string

Interface UpscaleParams

Hierarchy

  • UpscaleParams

Index

Properties

noise

Optional

noise?: NoiseType

style

Optional

style?: StyleType

upscale

Optional

upscale?: boolean

Interface VideoConvertParams

Hierarchy

  • VideoConvertParams

Index

Properties

access

Optional

access?: VideoAccess

aspect_mode

aspect_mode: VideoAccessMode

audio_bitrate

Optional

audio_bitrate?: number

audio_channels

Optional

audio_channels?: number

audio_codec

Optional

audio_codec?: AudioTypes

audio_sample_rate

Optional

audio_sample_rate?: number

clip_length

Optional

clip_length?: string

clip_offset

Optional

clip_offset?: string

container

Optional

container?: string

extname

Optional

extname?: string

filename

Optional

filename?: string

force

Optional

force?: boolean

fps

Optional

fps?: number

height

Optional

height?: number

keyframe_interval

Optional

keyframe_interval?: number

location

Optional

location?: Locations

path

Optional

path?: string

preset

Optional

preset?: VideoTypes

title

Optional

title?: string

two_pass

Optional

two_pass?: boolean

upscale

upscale: boolean

video_bitrate

Optional

video_bitrate?: number

watermark_bottom

Optional

watermark_bottom?: number

watermark_height

Optional

watermark_height?: number

watermark_left

Optional

watermark_left?: number

watermark_right

Optional

watermark_right?: number

watermark_top

Optional

watermark_top?: number

watermark_url

Optional

watermark_url?: string

watermark_width

Optional

watermark_width?: number

width

Optional

width?: number

Interface VignetteParams

Hierarchy

  • VignetteParams

Index

Properties

amount

Optional

amount?: number

background

Optional

background?: string

blurmode

Optional

blurmode?: BlurMode

Interface WatermarkParams

Hierarchy

  • WatermarkParams

Index

Properties

file

file: string

position

Optional

size

Optional

size?: number

Interface WebhookValidatePayload

Hierarchy

  • WebhookValidatePayload

Index

Properties

signature

signature: string

timestamp

timestamp: string