FilesDataSource
Defined in: js-api/src/dapi.ts:2230
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:2232
Parameters
| Parameter | Type | Default value |
|---|---|---|
root | string | '' |
Returns
FilesDataSource
Methods
createDirectory()
createDirectory(
file):Promise<void>
Defined in: js-api/src/dapi.ts:2388
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:2254
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:2238
Checks if a file exists. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
Returns
Promise<boolean>
list()
Call Signature
list(
file,options?):Promise<FileInfo[]>
Defined in: js-api/src/dapi.ts:2283
Lists files according to a search pattern. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type | Description |
|---|---|---|
file | string | FileInfo | folder |
options? | FileListOptions | - |
Returns
Promise<FileInfo[]>
Call Signature
list(
file,recursive?,searchPattern?):Promise<FileInfo[]>
Defined in: js-api/src/dapi.ts:2284
Lists files according to a search pattern. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type | Description |
|---|---|---|
file | string | FileInfo | folder |
recursive? | boolean | whether to search in folders recursively |
searchPattern? | string | 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:2261
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:2369
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:2356
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:2375
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:2363
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:2296
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:2325
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:2342
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:2271
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:2395
Writes a file. Sample: https://public.datagrok.ai/js/samples/dapi/files
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
blob? | number[] | Uint8Array<ArrayBufferLike> |
Returns
Promise<void>
writeAsText()
writeAsText(
file,data):Promise<void>
Defined in: js-api/src/dapi.ts:2403
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:2381
Writes a list of dataframes as a d42 file.
Parameters
| Parameter | Type |
|---|---|
file | string | FileInfo |
dataFrames | DataFrame[] |
Returns
Promise<void>