Skip to content

Class VirtualRoot

Source: virtualRoot.ts

A virtual folder that serves as the root folder

Extends

Accessors

absolutePath

Get Signature

get absolutePath(): string

Returns path without using any aliases

Returns

string

Inherited from

VirtualFolder.absolutePath


canBeEdited

Get Signature

get canBeEdited(): boolean

Returns whether this can be edited in its current state

Returns

boolean

Inherited from

VirtualFolder.canBeEdited


displayPath

Get Signature

get displayPath(): string

Returns path without using this item's alias

Returns

string

Overrides

VirtualFolder.displayPath


id

Get Signature

get id(): string

Returns

string

Inherited from

VirtualFolder.id


path

Get Signature

get path(): string

Returns the path of this item

Returns

string

Overrides

VirtualFolder.path

Constructors

Constructor

new VirtualRoot(systemManager: SystemManager): VirtualRoot

Parameters

systemManager

SystemManager

Returns

VirtualRoot

Overrides

VirtualFolder.constructor

Methods

addShortcut()

addShortcut(name: string, destination: VirtualFolder | VirtualFile | VirtualFileLink | VirtualFolderLink): VirtualRoot

Adds a shortcut to a file or folder

Parameters

name

string

destination

VirtualFolder | VirtualFile | VirtualFileLink | VirtualFolderLink

Returns

VirtualRoot


confirmChanges()

confirmChanges(root?: VirtualRoot): void

Parameters

root?

VirtualRoot

Returns

void

Inherited from

VirtualFolder.confirmChanges


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

VirtualFolder.createFile


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

VirtualFolder.createFileLink


createFileLinks(fileLinks: { name: string; }[]): this

Creates file links based on an array of objects with file names and extensions

Parameters

{ name: string; }[]

Returns

this

Inherited from

VirtualFolder.createFileLinks


createFiles()

createFiles(files: { extension: string; name: string; }[]): this

Creates files based on an array of objects with file names and extensions

Parameters

files

{ extension: string; name: string; }[]

Returns

this

Inherited from

VirtualFolder.createFiles


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

VirtualFolder.createFolder


createFolderLink(name: string, callback?: (newFolderLink: VirtualFolder | VirtualFolderLink) => void): this

Creates a folder link with a name

Parameters

name

string

callback?

(newFolderLink: VirtualFolder | VirtualFolderLink) => void

Returns

this

Inherited from

VirtualFolder.createFolderLink


createFolderLinks(names: string[]): this

Creates folder links based on an array of folder names

Parameters

names

string[]

Returns

this

Inherited from

VirtualFolder.createFolderLinks


createFolders()

createFolders(names: string[]): this

Creates folders based on an array of folder names

Parameters

names

string[]

Returns

this

Inherited from

VirtualFolder.createFolders


delete()

delete(): void

Deletes this folder and all its files and sub-folders recursively

Returns

void

Inherited from

VirtualFolder.delete


emit()

emit<Key>(eventName: Key, data?: unknown): void

Dispatch event

Type Parameters

Key

Key extends string

Parameters

eventName

Key

data?

unknown

Returns

void

Inherited from

VirtualFolder.emit


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

VirtualFolder.findFile


findSubFolder()

findSubFolder(name: string): VirtualFolder | VirtualFolderLink | null

Finds and returns a folder inside this folder matching a name

Parameters

name

string

Returns

VirtualFolder | VirtualFolderLink | null

Inherited from

VirtualFolder.findSubFolder


getFiles()

getFiles(showHidden: boolean): VirtualFile[]

Returns all files inside this folder

Parameters

showHidden

boolean = false

Whether to include hidden files

Returns

VirtualFile[]

Inherited from

VirtualFolder.getFiles


getIconUrl()

getIconUrl(): string

Returns

string

Inherited from

VirtualFolder.getIconUrl


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

VirtualFolder.getItemCount


getRoot()

getRoot(): VirtualRoot

Returns the root folder

Returns

VirtualRoot

Inherited from

VirtualFolder.getRoot


getSubFolders()

getSubFolders(showHidden: boolean): VirtualFolder[]

Returns all sub-folders inside this folder

Parameters

showHidden

boolean = false

Whether to include hidden folders

Returns

VirtualFolder[]

Inherited from

VirtualFolder.getSubFolders


getType()

getType(): string

Returns

string

Inherited from

VirtualFolder.getType


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

VirtualFolder.hasFile


hasFolder()

hasFolder(name: string): boolean

Returns true if this folder contains a folder matching a name

Parameters

name

string

Returns

boolean

Inherited from

VirtualFolder.hasFolder


init()

init(): VirtualRoot

Initializes this root by loading the default data and then the user's data on top

Returns

VirtualRoot


isFile()

isFile(): boolean

Returns

boolean

Inherited from

VirtualFolder.isFile


isFolder()

isFolder(): boolean

Returns

boolean

Inherited from

VirtualFolder.isFolder


isValidFileName()

static isValidFileName(_name: string): boolean

Parameters

_name

string

Returns

boolean


isValidFolderName()

static isValidFolderName(_name: string): boolean

Parameters

_name

string

Returns

boolean


isValidName()

static isValidName(_name: string): boolean

Parameters

_name

string

Returns

boolean


loadData()

loadData(): void

Returns

void


loadDefaultData()

loadDefaultData(): void

Returns

void


navigate(relativePath: string): VirtualFolder | VirtualFile | null

Returns the file or folder at a relative path or null if it doesn't exist

Parameters

relativePath

string

Returns

VirtualFolder | VirtualFile | null

Inherited from

VirtualFolder.navigate


off()

off<Key>(eventName: Key, callback: Listener): void

Remove event listener for an event

Type Parameters

Key

Key extends string

Parameters

eventName

Key

callback

Listener

Returns

void

Inherited from

VirtualFolder.off


on()

on<Key>(eventName: Key, callback: Listener): Listener

Add event listener for an event

Type Parameters

Key

Key extends string

Parameters

eventName

Key

callback

Listener

Returns

Listener

Inherited from

VirtualFolder.on


open()

open(windowsManager: WindowsManager): object | null | undefined

Opens this folder in file explorer

Parameters

windowsManager

WindowsManager

Returns

object | null | undefined

Inherited from

VirtualFolder.open


remove()

remove(child: VirtualFolder | VirtualFile | VirtualFileLink | VirtualFolderLink): this

Removes a file or folder from this folder

Parameters

child

VirtualFolder | VirtualFile | VirtualFileLink | VirtualFolderLink

Returns

this

Inherited from

VirtualFolder.remove


reset()

reset(): void

Tells the storage manager to clear all data and reloads the window

Returns

void


saveData()

saveData(): void

Calls the storage manager's store function with this root's data as a string

Returns

void


setAlias()

setAlias(alias: string): this

Parameters

alias

string

Returns

this

Inherited from

VirtualFolder.setAlias


setIconUrl()

setIconUrl(iconUrl: string | null): this

Parameters

iconUrl

string | null

Returns

this

Inherited from

VirtualFolder.setIconUrl


setName()

setName(name: string): this

Parameters

name

string

Returns

this

Inherited from

VirtualFolder.setName


setParent()

setParent(parent: VirtualFolder): this

Parameters

parent

VirtualFolder

Returns

this

Inherited from

VirtualFolder.setParent


setProtected()

setProtected(value: boolean): this

Parameters

value

boolean

Returns

this

Inherited from

VirtualFolder.setProtected


toJSON()

toJSON(): VirtualRootJson | null

Returns

VirtualRootJson | null

Overrides

VirtualFolder.toJSON


toString()

toString(): string | null

Returns a string representation of an object.

Returns

string | null

Overrides

VirtualFolder.toString

Properties

alias

alias: string | null | undefined

The alias of this item

Inherited from

VirtualFolder.alias


editedByUser

editedByUser: boolean | null | undefined

Whether this item has been edited by the user

Inherited from

VirtualFolder.editedByUser


EVENT_NAMES

static EVENT_NAMES: { error: string; update: string; }

error

error: string = "error"

update

update: string = "update"

Overrides

VirtualFolder.EVENT_NAMES


files

files: (VirtualFile | VirtualFileLink)[]

The files inside this folder

Inherited from

VirtualFolder.files


iconUrl

iconUrl: string | null | undefined

The URL of the icon of this item

Inherited from

VirtualFolder.iconUrl


initiated

initiated: boolean = false


isDeleted

isDeleted: boolean

Whether this item has been deleted

Inherited from

VirtualFolder.isDeleted


isProtected

isProtected: boolean | null | undefined

Whether this item is protected from changes

Inherited from

VirtualFolder.isProtected


isRoot

isRoot: boolean | null | undefined

Whether this item is the root folder

Inherited from

VirtualFolder.isRoot


linkedFile

linkedFile: VirtualFile | null | undefined

The file this item links to

Inherited from

VirtualFolder.linkedFile


linkedFolder

linkedFolder: VirtualFolder | null | undefined

The folder this item links to

Inherited from

VirtualFolder.linkedFolder


loadedDefaultData

loadedDefaultData: boolean = false


name

name: string

The name of this item

Inherited from

VirtualFolder.name


parent

parent: VirtualFolder | null | undefined

The folder this item is in

Inherited from

VirtualFolder.parent


root

root: VirtualRoot | null | undefined

The root folder

Inherited from

VirtualFolder.root


shortcuts

shortcuts: Record<string, VirtualFile | VirtualFileLink | VirtualFolder | VirtualFolderLink>

Aliases for files and folders


subFolders

subFolders: (VirtualFolder | VirtualFolderLink)[]

The folders inside this folder

Inherited from

VirtualFolder.subFolders


systemManager

systemManager: SystemManager


type

type: number | undefined

The type of this folder

Default

ts
VirtualFolder.TYPE.general

Inherited from

VirtualFolder.type


TYPE

static TYPE: { general: number; media: number; }

general

general: number = 0

media

media: number = 1

Inherited from

VirtualFolder.TYPE

Built by Prozilla