useFile

useFile( fileId: string, options?: FileInfoOptions, deps?: any[]): IFileInfo | null | undefined; useFile( fileId: string, options?: FileBlobOptions, deps?: any[]): Blob | null | undefined; useFile( fileId: string, options?: FileTextOptions, deps?: any[]): string | null | undefined; useFile( fileId: string, options?: FileBufferOptions, deps?: any[]): ArrayBuffer | null | undefined;

Returns a file from file collection.

Examples

Get file info by ID,

const fileInfo = useFile("5ee53613-bc0f-4b2a-9904-b21afd8431a7");

Get file info by server relative path,

const assetInfo = useFile("/sites/mysite/SiteAssets/example.png");

Get file content as Blob,

const fileContentAsBlob = useFile("5ee53613-bc0f-4b2a-9904-b21afd8431a7", { type: "blob" });

Get file content as ArrayBuffer,

const fileContentAsBuffer = useFile("5ee53613-bc0f-4b2a-9904-b21afd8431a7", { type: "buffer" });

Get file content as string,

const fileContentAsText = useFile("5ee53613-bc0f-4b2a-9904-b21afd8431a7", { type: "text" });

Parameters

NameTypeDescriptionTracked for changes
fileIdstringfile UUID or server relative pathYes
options?FileInfoOptions | FileBlobOptions | FileTextOptions | FileBufferOptionsuseFile hook optionsPartially
deps?DependencyListHook dependency list.Yes