FilesDataSource
Defined in: js-api/src/dapi.ts:2105
Provides access to file operations in the Datagrok file system.
Allows reading, writing, listing, and managing files and directories in user file shares and data connections.
Access via grok.dapi.files.
Example
// List files
const files = await grok.dapi.files.list('System:AppData/MyApp');
// Read a file
const content = await grok.dapi.files.readAsText('System:AppData/MyApp/config.json');
// Write a file
await grok.dapi.files.writeAsText('System:AppData/MyApp/output.txt', 'Hello, World!');
Constructors
Constructor
new FilesDataSource(
root?):FilesDataSource
Defined in: js-api/src/dapi.ts:2107
Parameters
| Parameter | Type | Default value |
|---|---|---|
root | string | '' |
Returns
FilesDataSource
Methods
createDirectory()
createDirectory(
file):Promise<void>
Defined in: js-api/src/dapi.ts:2263
Creates directory Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<void>
delete()
delete(
file):Promise<void>
Defined in: js-api/src/dapi.ts:2129
Deletes a file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<void>
exists()
exists(
file):Promise<boolean>
Defined in: js-api/src/dapi.ts:2113
Checks if a file exists. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<boolean>
list()
list(
file,recursive?,searchPattern?):Promise<FileInfo[]>
Defined in: js-api/src/dapi.ts:2158
Lists files according to a search pattern. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
file | string | FileInfo | undefined | folder |
recursive | boolean | false | whether to search in folders recursively |
searchPattern | string | null | null | search pattern, such as part of a filename or extension, e.g., "filename-prefix" and "csv" |
Returns
Promise<FileInfo[]>
move()
move(
files,newPath):Promise<void>
Defined in: js-api/src/dapi.ts:2136
Moves a file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
files | string[] | FileInfo[] |
newPath | string |
Returns
Promise<void>
readAsBytes()
readAsBytes(
file):Promise<Uint8Array<ArrayBufferLike>>
Defined in: js-api/src/dapi.ts:2244
Reads a file as bytes. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<Uint8Array<ArrayBufferLike>>
readAsText()
readAsText(
file):Promise<string>
Defined in: js-api/src/dapi.ts:2231
Reads a file as string. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<string>
readBinaryDataFrames()
readBinaryDataFrames(
file):Promise<DataFrame[]>
Defined in: js-api/src/dapi.ts:2250
Reads a d42 file as a list of dataframes.
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<DataFrame[]>
readCsv()
readCsv(
file,options?):Promise<DataFrame>
Defined in: js-api/src/dapi.ts:2238
Reads CSV as DataFrame. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
options? | CsvImportOptions |
Returns
Promise<DataFrame>
readFilesAsBlobs()
readFilesAsBlobs(
folder,recursive?,ext?):Promise<{[key:string]:Blob; }>
Defined in: js-api/src/dapi.ts:2169
Reads the entire contents of a folder and returns an object. The resulting object's keys are the file names relative to the folder path, and the corresponding values are of the Blob type.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
folder | string | FileInfo | undefined | - |
recursive | boolean | false | whether to read files in folders recursively |
ext | string | undefined | undefined | files extension |
Returns
Promise<{[key: string]: Blob; }>
readFilesAsJson()
readFilesAsJson(
folder,recursive?,ext?):Promise<{[key:string]:any; }>
Defined in: js-api/src/dapi.ts:2199
Reads the entire contents of a folder and returns an object. The resulting object's keys are the file names relative to the folder path, and the corresponding values are JSON objects. If conversion to a JSON fails, the file will be skipped.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
folder | string | FileInfo | undefined | - |
recursive | boolean | false | whether to read files in folders recursively |
ext | string | undefined | undefined | files extension |
Returns
Promise<{[key: string]: any; }>
readFilesAsString()
readFilesAsString(
folder,recursive?,ext?):Promise<{[key:string]:string; }>
Defined in: js-api/src/dapi.ts:2217
Reads the entire contents of a folder and returns an object. The resulting object's keys are the file names relative to the folder path, and the corresponding values are strings. If conversion to a string fails, the file will be skipped.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
folder | string | FileInfo | undefined | - |
recursive | boolean | false | whether to read files in folders recursively |
ext | string | undefined | undefined | files extension |
Returns
Promise<{[key: string]: string; }>
rename()
rename(
file,newName):Promise<void>
Defined in: js-api/src/dapi.ts:2146
Renames a file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
newName | string |
Returns
Promise<void>
write()
write(
file,blob?):Promise<void>
Defined in: js-api/src/dapi.ts:2270
Writes a file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
blob? | number[] |
Returns
Promise<void>
writeAsText()
writeAsText(
file,data):Promise<void>
Defined in: js-api/src/dapi.ts:2278
Writes a text file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
data | string |
Returns
Promise<void>
writeBinaryDataFrames()
writeBinaryDataFrames(
file,dataFrames):Promise<void>
Defined in: js-api/src/dapi.ts:2256
Writes a list of dataframes as a d42 file.
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
dataFrames | DataFrame[] |
Returns
Promise<void>