FileOpsAPI
Defined in: namespaces.ts:130
Methods
Section titled “Methods”getSelectedFiles()
Section titled “getSelectedFiles()”getSelectedFiles():
Promise<PluginFileDescriptor[]>
Defined in: namespaces.ts:133
Returns file descriptors for the active pane’s selected files.
Returns
Section titled “Returns”Promise<PluginFileDescriptor[]>
getActiveDirectory()
Section titled “getActiveDirectory()”getActiveDirectory():
Promise<string>
Defined in: namespaces.ts:135
Returns the URL string of the active pane’s current directory.
Returns
Section titled “Returns”Promise<string>
getPaneDirectory()
Section titled “getPaneDirectory()”getPaneDirectory(
paneId):Promise<string>
Defined in: namespaces.ts:137
Returns the URL string of the specified pane’s directory.
Parameters
Section titled “Parameters”paneId
Section titled “paneId”string
Returns
Section titled “Returns”Promise<string>
listDirectory()
Section titled “listDirectory()”listDirectory(
url):Promise<PluginFileDescriptor[]>
Defined in: namespaces.ts:139
Lists directory contents.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<PluginFileDescriptor[]>
getFileInfo()
Section titled “getFileInfo()”getFileInfo(
url):Promise<PluginFileDescriptor>
Defined in: namespaces.ts:141
Returns metadata for a single file.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<PluginFileDescriptor>
readFile()
Section titled “readFile()”readFile(
url,encoding?):Promise<string>
Defined in: namespaces.ts:143
Reads a text file.
Parameters
Section titled “Parameters”string
encoding?
Section titled “encoding?”string
Returns
Section titled “Returns”Promise<string>
readFileData()
Section titled “readFileData()”readFileData(
url):Promise<string>
Defined in: namespaces.ts:145
Reads a file as a base64-encoded string.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<string>
copy()
Section titled “copy()”copy(
sources,dest):Promise<void>
Defined in: namespaces.ts:149
Copies files to a destination directory.
Parameters
Section titled “Parameters”sources
Section titled “sources”string[]
string
Returns
Section titled “Returns”Promise<void>
move()
Section titled “move()”move(
sources,dest):Promise<void>
Defined in: namespaces.ts:151
Moves files to a destination directory.
Parameters
Section titled “Parameters”sources
Section titled “sources”string[]
string
Returns
Section titled “Returns”Promise<void>
delete()
Section titled “delete()”delete(
urls,trash?):Promise<void>
Defined in: namespaces.ts:153
Deletes files.
Parameters
Section titled “Parameters”string[]
trash?
Section titled “trash?”boolean
Returns
Section titled “Returns”Promise<void>
rename()
Section titled “rename()”rename(
url,newName):Promise<string>
Defined in: namespaces.ts:155
Renames a file. Returns the new URL string.
Parameters
Section titled “Parameters”string
newName
Section titled “newName”string
Returns
Section titled “Returns”Promise<string>
createDirectory()
Section titled “createDirectory()”createDirectory(
parentUrl,name):Promise<string>
Defined in: namespaces.ts:157
Creates a new directory. Returns the URL string.
Parameters
Section titled “Parameters”parentUrl
Section titled “parentUrl”string
string
Returns
Section titled “Returns”Promise<string>
createFile()
Section titled “createFile()”createFile(
parentUrl,name,contents?):Promise<string>
Defined in: namespaces.ts:159
Creates a new file with optional initial contents. Returns the URL string.
Parameters
Section titled “Parameters”parentUrl
Section titled “parentUrl”string
string
contents?
Section titled “contents?”string
Returns
Section titled “Returns”Promise<string>
writeFile()
Section titled “writeFile()”writeFile(
url,contents,encoding?):Promise<void>
Defined in: namespaces.ts:161
Writes text content to an existing file.
Parameters
Section titled “Parameters”string
contents
Section titled “contents”string
encoding?
Section titled “encoding?”string
Returns
Section titled “Returns”Promise<void>
batch()
Section titled “batch()”batch(
operations):Promise<BatchResult[]>
Defined in: namespaces.ts:163
Executes multiple file operations as a batch.
Parameters
Section titled “Parameters”operations
Section titled “operations”Returns
Section titled “Returns”Promise<BatchResult[]>
watchDirectory()
Section titled “watchDirectory()”watchDirectory(
url,handler):string
Defined in: namespaces.ts:167
Watches a directory for changes. Returns subscription ID.
Parameters
Section titled “Parameters”string
handler
Section titled “handler”(changedPaths) => void
Returns
Section titled “Returns”string
watchDirectoryWithOptions()
Section titled “watchDirectoryWithOptions()”watchDirectoryWithOptions(
url,options,handler):string
Defined in: namespaces.ts:169
Watches a directory for changes with configurable debounce and recursion.
Parameters
Section titled “Parameters”string
options
Section titled “options”handler
Section titled “handler”(changedPaths) => void
Returns
Section titled “Returns”string
unwatchDirectory()
Section titled “unwatchDirectory()”unwatchDirectory(
subscriptionId):void
Defined in: namespaces.ts:175
Cancels a directory watcher subscription.
Parameters
Section titled “Parameters”subscriptionId
Section titled “subscriptionId”string
Returns
Section titled “Returns”void
onBeforeOperation()
Section titled “onBeforeOperation()”onBeforeOperation(
type,handler):string
Defined in: namespaces.ts:179
Registers a before-operation hook.
Parameters
Section titled “Parameters”FileOperationType | FileOperationType[]
handler
Section titled “handler”(event) => void | BeforeHookResult
Returns
Section titled “Returns”string
onAfterOperation()
Section titled “onAfterOperation()”onAfterOperation(
type,handler):string
Defined in: namespaces.ts:184
Registers an after-operation hook.
Parameters
Section titled “Parameters”FileOperationType | FileOperationType[]
handler
Section titled “handler”(event) => void
Returns
Section titled “Returns”string
removeBeforeHook()
Section titled “removeBeforeHook()”removeBeforeHook(
subscriptionId):void
Defined in: namespaces.ts:189
Removes a before-hook subscription.
Parameters
Section titled “Parameters”subscriptionId
Section titled “subscriptionId”string
Returns
Section titled “Returns”void
removeAfterHook()
Section titled “removeAfterHook()”removeAfterHook(
subscriptionId):void
Defined in: namespaces.ts:191
Removes an after-hook subscription.
Parameters
Section titled “Parameters”subscriptionId
Section titled “subscriptionId”string
Returns
Section titled “Returns”void