Class VirtualRoot
Source: virtualRoot.ts
A virtual folder that serves as the root folder.
Extends
Constructors
Constructor
new VirtualRoot(
systemManager:SystemManager):VirtualRoot
Parameters
systemManager
Returns
VirtualRoot
Overrides
Properties
subFolders
subFolders: (
VirtualFolder<VirtualBaseEvents> |VirtualFolderLink)[]
The folders inside this folder.
Inherited from
files
files: (
VirtualFile|VirtualFileLink)[]
The files inside this folder.
Inherited from
type
type:
number|undefined
The type of this folder.
Default
VirtualFolder.TYPE.generalInherited from
TYPE
staticTYPE: {general:number;media:number; }
general
general:
number=0
media
media:
number=1
Inherited from
shortcuts
shortcuts:
Record<string,VirtualFile|VirtualFileLink|VirtualFolder|VirtualFolderLink>
Aliases for files and folders.
initiated
initiated:
boolean=false
loadedDefaultData
loadedDefaultData:
boolean=false
systemManager
systemManager:
SystemManager
storage
storage:
VirtualDriveStorage
ERROR_EVENT
readonlystaticERROR_EVENT:"error"="error"
name
name:
string
The name of this item.
Inherited from
alias
alias:
string|null|undefined
The alias of this item.
Inherited from
parent
parent:
VirtualFolder<VirtualBaseEvents> |null|undefined
The folder this item is in.
Inherited from
isProtected
isProtected:
boolean|null|undefined
Whether this item is protected from changes.
Inherited from
iconUrl
iconUrl:
string|null|undefined
The URL of the icon of this item.
Inherited from
linkedFile
linkedFile:
VirtualFile|null|undefined
The file this item links to.
Inherited from
linkedFolder
linkedFolder:
VirtualFolder<VirtualBaseEvents> |null|undefined
The folder this item links to.
Inherited from
editedByUser
editedByUser:
boolean|null|undefined
Whether this item has been edited by the user.
Inherited from
isRoot
isRoot:
boolean|null|undefined
Whether this item is the root folder.
Inherited from
root
root:
VirtualRoot|null|undefined
The root folder.
Inherited from
isDeleted
isDeleted:
boolean
Whether this item has been deleted.
Inherited from
UPDATE_EVENT
readonlystaticUPDATE_EVENT:"update"="update"
Inherited from
Methods
setAlias()
setAlias(
alias:string):this
Parameters
alias
string
Returns
this
Inherited from
hasFile()
hasFile(
name:string,extension?:string):boolean
Returns true if this folder contains a file matching a name and extension.
Parameters
name
string
extension?
string
Returns
boolean
Inherited from
hasFolder()
hasFolder(
name:string):boolean
Returns true if this folder contains a folder matching a name.
Parameters
name
string
Returns
boolean
Inherited from
findFile()
findFile(
name:string,extension?:string|null):VirtualFile|VirtualFileLink|null
Finds and returns a file inside this folder matching a name and extension.
Parameters
name
string
extension?
string | null
Returns
VirtualFile | VirtualFileLink | null
Inherited from
findSubFolder()
findSubFolder(
name:string):VirtualFolder<VirtualBaseEvents> |VirtualFolderLink|null
Finds and returns a folder inside this folder matching a name.
Parameters
name
string
Returns
VirtualFolder<VirtualBaseEvents> | VirtualFolderLink | null
Inherited from
addFile()
addFile(
file:VirtualFile,confirmChanges:boolean):this
Parameters
file
confirmChanges
boolean = true
Returns
this
Inherited from
createFile()
createFile(
name:string,extension?:string,callback?: (newFile:VirtualFile|VirtualFileLink) =>void):this
Creates a file with a name and extension.
Parameters
name
string
extension?
string
callback?
(newFile: VirtualFile | VirtualFileLink) => void
Returns
this
Inherited from
createFiles()
createFiles(
files: {name:string;extension:string; }[]):this
Creates files based on an array of objects with file names and extensions.
Parameters
files
{ name: string; extension: string; }[]
Returns
this
Inherited from
createFileLink()
createFileLink(
name:string,callback?: (newFileLink:VirtualFile|VirtualFileLink) =>void):this
Creates a file link with a name.
Parameters
name
string
callback?
(newFileLink: VirtualFile | VirtualFileLink) => void
Returns
this
Inherited from
createFileLinks()
createFileLinks(
fileLinks: {name:string; }[]):this
Creates file links based on an array of objects with file names and extensions.
Parameters
fileLinks
{ name: string; }[]
Returns
this
Inherited from
addFolder()
addFolder(
folder:VirtualFolder,confirmChanges:boolean):this
Parameters
folder
confirmChanges
boolean = true
Returns
this
Inherited from
createFolder()
createFolder(
name:string,callback?: (newFolder:VirtualFolder) =>void):this
Creates a folder with a name.
Parameters
name
string
callback?
(newFolder: VirtualFolder) => void
Returns
this
Inherited from
createFolders()
createFolders(
names:string[]):this
Creates folders based on an array of folder names.
Parameters
names
string[]
Returns
this
Inherited from
createFolderLink()
createFolderLink(
name:string,callback?: (newFolderLink:VirtualFolder<VirtualBaseEvents> |VirtualFolderLink) =>void):this
Creates a folder link with a name.
Parameters
name
string
callback?
(newFolderLink: VirtualFolder<VirtualBaseEvents> | VirtualFolderLink) => void
Returns
this
Inherited from
VirtualFolder.createFolderLink
createFolderLinks()
createFolderLinks(
names:string[]):this
Creates folder links based on an array of folder names.
Parameters
names
string[]
Returns
this
Inherited from
VirtualFolder.createFolderLinks
remove()
remove(
child:VirtualFolder<VirtualBaseEvents> |VirtualFile|VirtualFileLink|VirtualFolderLink):this
Removes a file or folder from this folder.
Parameters
child
VirtualFolder<VirtualBaseEvents> | VirtualFile | VirtualFileLink | VirtualFolderLink
Returns
this
Inherited from
navigate()
navigate(
relativePath:string):VirtualFolder<VirtualBaseEvents> |VirtualFile|null
Returns the file or folder at a relative path or null if it doesn't exist.
Parameters
relativePath
string
Returns
VirtualFolder<VirtualBaseEvents> | VirtualFile | null
Inherited from
open()
open(
windowsManager:WindowsManager):object|null|undefined
Opens this folder in file explorer.
Parameters
windowsManager
Returns
object | null | undefined
Inherited from
delete()
delete():
void
Deletes this folder and all its files and sub-folders recursively.
Returns
void
Inherited from
getFiles()
getFiles(
showHidden:boolean):VirtualFile[]
Returns all files inside this folder.
Parameters
showHidden
boolean = false
Whether to include hidden files.
Returns
Inherited from
getSubFolders()
getSubFolders(
showHidden:boolean):VirtualFolder<VirtualBaseEvents>[]
Returns all sub-folders inside this folder.
Parameters
showHidden
boolean = false
Whether to include hidden folders.
Returns
VirtualFolder<VirtualBaseEvents>[]
Inherited from
getItemCount()
getItemCount(
includeHidden:boolean):number
Returns the amount of files and sub-folders inside this folder.
Parameters
includeHidden
boolean = false
Whether to include hidden files and folders in the count.
Returns
number
Inherited from
isFolder()
isFolder():
this is VirtualFolder<VirtualBaseEvents>
Returns
this is VirtualFolder<VirtualBaseEvents>
Inherited from
getIconUrl()
getIconUrl():
string
Returns
string
Inherited from
loadDefaultData()
loadDefaultData():
void
Returns
void
loadData()
loadData():
void
Returns
void
saveData()
saveData():
void
Calls the storage manager's store function with this root's data as a string.
Returns
void
init()
init():
VirtualRoot
Initializes this root by loading the default data and then the user's data on top.
Returns
VirtualRoot
addShortcut()
addShortcut(
name:string,destination:VirtualFolder<VirtualBaseEvents> |VirtualFile|VirtualFileLink|VirtualFolderLink):VirtualRoot
Adds a shortcut to a file or folder.
Parameters
name
string
destination
VirtualFolder<VirtualBaseEvents> | VirtualFile | VirtualFileLink | VirtualFolderLink
Returns
VirtualRoot
reset()
reset():
void
Tells the storage manager to clear all data and reloads the window.
Returns
void
isValidName()
staticisValidName(_name:string):boolean
Parameters
_name
string
Returns
boolean
isValidFileName()
staticisValidFileName(_name:string):boolean
Parameters
_name
string
Returns
boolean
isValidFolderName()
staticisValidFolderName(_name:string):boolean
Parameters
_name
string
Returns
boolean
toJSON()
toJSON():
VirtualRootJson|null
Returns
VirtualRootJson | null
Overrides
toString()
toString():
string|null
Returns a string representation of an object.
Returns
string | null
Overrides
setName()
setName(
name:string):this
Parameters
name
string
Returns
this
Inherited from
setParent()
setParent(
parent:VirtualFolder):this
Parameters
parent
Returns
this
Inherited from
setProtected()
setProtected(
value:boolean):this
Parameters
value
boolean
Returns
this
Inherited from
setIconUrl()
setIconUrl(
iconUrl:string|null):this
Parameters
iconUrl
string | null
Returns
this
Inherited from
getType()
getType():
string
Returns
string
Inherited from
confirmChanges()
confirmChanges(
root?:VirtualRoot):void
Parameters
root?
VirtualRoot
Returns
void
Inherited from
getRoot()
getRoot():
VirtualRoot
Returns the root folder.
Returns
VirtualRoot
Inherited from
isFile()
isFile():
this is VirtualFile
Returns
this is VirtualFile
Inherited from
on()
on<
K>(event:K,listener:Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>):Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>
Starts listening to an event.
Type Parameters
K
K extends keyof VirtualRootEvents
Parameters
event
K
The event to listen to.
listener
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The function to call when the event is emitted.
Returns
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The listener.
Inherited from
once()
once<
K>(event:K,listener:Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>):Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>
Registers an event listener that is automatically removed when called.
Type Parameters
K
K extends keyof VirtualRootEvents
Parameters
event
K
The event to listen to.
listener
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The function to call once the event is emitted.
Returns
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The wrapped listener.
Inherited from
onAsync()
onAsync<
K>(event:K,listener:AsyncListener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>,onRejected?: (reason:any) =>unknown|null):Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>
Starts listening to an event.
Type Parameters
K
K extends keyof VirtualRootEvents
Parameters
event
K
The event to listen to.
listener
AsyncListener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The function to call when the event is emitted.
onRejected?
(reason: any) => unknown | null
Returns
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The wrapped listener.
Inherited from
off()
off<
K>(event:K,listener:Listener<VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>,K>):void
Removes an event listener.
Type Parameters
K
K extends keyof VirtualRootEvents
Parameters
event
K
The event to remove the listener from.
listener
Listener<VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>, K>
The listener to remove.
Returns
void
Inherited from
emit()
emit<
K>(event:K, ...args:VirtualRootEvents&Record<keyofVirtualRootEvents,unknown[]>[K]):void
Emits an event to all its listeners.
Type Parameters
K
K extends keyof VirtualRootEvents
Parameters
event
K
The event to emit.
args
...VirtualRootEvents & Record<keyof VirtualRootEvents, unknown[]>[K]
The arguments to pass to the listeners.
Returns
void
Inherited from
Accessors
path
Get Signature
get path():
string
Returns the path of this item.
Returns
string
Overrides
displayPath
Get Signature
get displayPath():
string
Returns path without using this item's alias.
Returns
string
Overrides
id
Get Signature
get id():
string
Returns
string
Inherited from
absolutePath
Get Signature
get absolutePath():
string
Returns path without using any aliases.
Returns
string
Inherited from
VirtualFolderLink.absolutePath
canBeEdited
Get Signature
get canBeEdited():
boolean
Returns whether this can be edited in its current state.
Returns
boolean