Class WorkspaceService

The workspace service.

Implements

FrontendApplicationContribution
WorkspaceOpenHandlerContribution

Index

Constructors

constructor

Accessors

isMultiRootWorkspaceOpened onWorkspaceChanged onWorkspaceLocationChanged opened ready roots saved workspace

Constructors

constructor

new WorkspaceService(): WorkspaceService
Returns WorkspaceService

Properties

`Protected` _ready

_ready: Deferred<void> = ...

`Protected` _roots

_roots: FileStat[] = []

`Protected` _workspace

_workspace: undefined | FileStat

`Protected` deferredRoots

deferredRoots: Deferred<FileStat[]> = ...

`Protected` `Readonly` envVariableServer

envVariableServer: EnvVariablesServer

`Protected` `Readonly` fileService

fileService: FileService

`Protected` `Readonly` fsPreferences

fsPreferences: FileSystemPreferences

`Protected` `Readonly` labelProvider

labelProvider: LabelProvider

`Protected` logger

logger: ILogger

`Protected` `Readonly` messageService

messageService: MessageService

`Protected` `Readonly` onWorkspaceChangeEmitter

onWorkspaceChangeEmitter: Emitter<FileStat[]> = ...

`Protected` `Readonly` onWorkspaceLocationChangedEmitter

onWorkspaceLocationChangedEmitter: Emitter<undefined | FileStat> = ...

`Protected` `Readonly` openHandlerContribution

openHandlerContribution: ContributionProvider<WorkspaceOpenHandlerContribution>

`Protected` `Readonly` preferenceImpl

preferenceImpl: PreferenceServiceImpl

`Protected` preferences

preferences: WorkspacePreferences

`Protected` `Readonly` rootWatchers

rootWatchers: Map<string, Disposable> = ...

`Protected` `Readonly` schemaProvider

schemaProvider: PreferenceSchemaProvider

`Protected` `Readonly` schemaUpdater

schemaUpdater: WorkspaceSchemaUpdater

`Protected` `Readonly` server

server: WorkspaceServer

`Protected` `Readonly` toDisposeOnWorkspace

toDisposeOnWorkspace: DisposableCollection = ...

`Protected` `Readonly` untitledWorkspaceService

untitledWorkspaceService: UntitledWorkspaceService

`Protected` `Readonly` windowService

windowService: WindowService

`Protected` `Readonly` windowTitleService

windowTitleService: WindowTitleService

`Protected` `Readonly` workspaceFileService

workspaceFileService: WorkspaceFileService

Accessors

isMultiRootWorkspaceOpened

get isMultiRootWorkspaceOpened(): boolean
Returns true if a multiple-root workspace is currently open.

Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:353

onWorkspaceChanged

get onWorkspaceChanged(): Event<FileStat[]>
Returns Event<FileStat[]>
- Defined in packages/workspace/src/browser/workspace-service.ts:196

onWorkspaceLocationChanged

get onWorkspaceLocationChanged(): Event<undefined | FileStat>
Returns Event<undefined | FileStat>
- Defined in packages/workspace/src/browser/workspace-service.ts:201

opened

get opened(): boolean
Returns true if theia has an opened workspace or folder

Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:345

ready

get ready(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:107

roots

get roots(): Promise<FileStat[]>
Returns Promise<FileStat[]>
- Defined in packages/workspace/src/browser/workspace-service.ts:185

saved

get saved(): boolean
true if the current workspace is configured using a configuration file.

false if there is no workspace or the workspace is simply a folder.

Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:591

workspace

get workspace(): undefined | FileStat
Returns undefined | FileStat
- Defined in packages/workspace/src/browser/workspace-service.ts:191

Methods

addRoot

addRoot(uris): Promise<void>
Adds root folder(s) to the workspace
Parameters
- uris: URI | URI[]
  URI or URIs of the root folder(s) to add
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:407

areWorkspaceRoots

areWorkspaceRoots(uris): boolean
Parameters
- uris: URI[]
Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:695

canHandle

canHandle(uri): Promise<boolean>
Parameters
- uri: URI
Returns Promise<boolean>
Implementation of WorkspaceOpenHandlerContribution.canHandle
- Defined in packages/workspace/src/browser/workspace-service.ts:374

close

close(): Promise<void>
Clears current workspace root.

Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:487

`Protected` computeRoots

computeRoots(): Promise<FileStat[]>
Returns Promise<FileStat[]>
- Defined in packages/workspace/src/browser/workspace-service.ts:258

containsSome

containsSome(paths): Promise<boolean>
Return true if one of the paths in paths array is present in the workspace NOTE: You should always explicitly use / as the separator between the path segments.
Parameters
- paths: string[]
Returns Promise<boolean>
- Defined in packages/workspace/src/browser/workspace-service.ts:569

`Protected` doGetDefaultWorkspaceUri

doGetDefaultWorkspaceUri(): Promise<undefined | string>
Returns Promise<undefined | string>
- Defined in packages/workspace/src/browser/workspace-service.ts:148

`Protected` doInit

doInit(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:116

`Protected` doOpen

doOpen(uri, options?): Promise<void>
Parameters
- uri: URI
- Optional options: WorkspaceInput
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:364

`Protected` getDefaultWorkspaceUri

getDefaultWorkspaceUri(): MaybePromise<undefined | string>
Resolves to the default workspace URI as string.

The default implementation tries to extract the default workspace location from the window.location.hash, then falls-back to the most recently used workspace root from the server.

It is not ensured that the resolved workspace URI is valid, it can point to a non-existing location.

Returns MaybePromise<undefined | string>
- Defined in packages/workspace/src/browser/workspace-service.ts:144

`Protected` getExcludes

getExcludes(uri): string[]
Parameters
- uri: string
Returns string[]
- Defined in packages/workspace/src/browser/workspace-service.ts:666

getUntitledWorkspace

getUntitledWorkspace(): Promise<URI>
Returns Promise<URI>
- Defined in packages/workspace/src/browser/workspace-service.ts:461

`Protected` getWorkspaceDataFromFile

getWorkspaceDataFromFile(): Promise<undefined | WorkspaceData>
Returns Promise<undefined | WorkspaceData>
- Defined in packages/workspace/src/browser/workspace-service.ts:280

getWorkspaceRootUri

getWorkspaceRootUri(uri): undefined | URI
Returns the workspace root uri that the given file belongs to. In case that the file is found in more than one workspace roots, returns the root that is closest to the file. If the file is not from the current workspace, returns undefined.
Parameters
- uri: undefined | URI
  URI of the file
Returns undefined | URI
- Defined in packages/workspace/src/browser/workspace-service.ts:677

`Protected` init

init(): void
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:112

isSafeToReload

isSafeToReload(withURI?): Promise<boolean>
Parameters
- Optional withURI: URI
Returns Promise<boolean>
- Defined in packages/workspace/src/browser/workspace-service.ts:716

isUntitledWorkspace

isUntitledWorkspace(candidate?): boolean
Parameters
- Optional candidate: URI
Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:712

`Protected` isWorkspaceFile

isWorkspaceFile(candidate): boolean
Check if the file should be considered as a workspace file.

Example: We should not try to read the contents of an .exe file.
Parameters
- candidate: URI | FileStat
Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:708

onStop

onStop(): void
on unload, we set our workspace root as the last recently used on the backend.

Returns void
Implementation of FrontendApplicationContribution.onStop
- Defined in packages/workspace/src/browser/workspace-service.ts:329

open

open(uri, options?): void
Opens directory, or recreates a workspace from the file that uri points to.
Parameters
- uri: URI
- Optional options: WorkspaceInput
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:360

`Protected` openNewWindow

openNewWindow(workspacePath, options?): void
Parameters
- workspacePath: string
- Optional options: WorkspaceInput
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:555

`Protected` openWindow

openWindow(uri, options?): void
Parameters
- uri: FileStat
- Optional options: WorkspaceInput
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:528

openWorkspace

openWorkspace(uri, options?): Promise<void>
Parameters
- uri: URI
- Optional options: WorkspaceInput
Returns Promise<void>
Implementation of WorkspaceOpenHandlerContribution.openWorkspace
- Defined in packages/workspace/src/browser/workspace-service.ts:378

recentWorkspaces

recentWorkspaces(): Promise<string[]>
Returns Promise<string[]>
- Defined in packages/workspace/src/browser/workspace-service.ts:333

`Protected` refreshRootWatchers

refreshRootWatchers(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:643

`Protected` reloadWindow

reloadWindow(options?): void
Parameters
- Optional options: WorkspaceInput
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:544

removeRecentWorkspace

removeRecentWorkspace(uri): Promise<void>
Parameters
- uri: string
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:337

removeRoots

removeRoots(uris): Promise<void>
Removes root folder(s) from workspace.
Parameters
- uris: URI[]
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:415

save

save(uri): Promise<void>
Save workspace data into a file
Parameters
- uri: URI | FileStat
  URI or FileStat of the workspace file
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:599

`Protected` setURLFragment

setURLFragment(workspacePath): void
Set the URL fragment to the given workspace path.
Parameters
- workspacePath: string
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:181

`Protected` setWorkspace

setWorkspace(workspaceStat): Promise<void>
Parameters
- workspaceStat: undefined | FileStat
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:206

`Protected` shouldPreserveWindow

shouldPreserveWindow(options?): boolean
Parameters
- Optional options: WorkspaceInput
Returns boolean
- Defined in packages/workspace/src/browser/workspace-service.ts:561

spliceRoots

spliceRoots(start, deleteCount?, ...rootsToAdd): Promise<URI[]>
Parameters
- start: number
- Optional deleteCount: number
- Rest ...rootsToAdd: URI[]
Returns Promise<URI[]>
- Defined in packages/workspace/src/browser/workspace-service.ts:431

`Protected` toFileStat

toFileStat(uri): Promise<undefined | FileStat>
returns a FileStat if the argument URI points to a file or directory. Otherwise, undefined.
Parameters
- uri: undefined | string | URI
Returns Promise<undefined | FileStat>
- Defined in packages/workspace/src/browser/workspace-service.ts:512

`Protected` toValidRoot

toValidRoot(uri): Promise<undefined | FileStat>
returns a FileStat if the argument URI points to an existing directory. Otherwise, undefined.
Parameters
- uri: undefined | string | URI
Returns Promise<undefined | FileStat>
- Defined in packages/workspace/src/browser/workspace-service.ts:501

tryGetRoots

tryGetRoots(): FileStat[]
Returns FileStat[]
- Defined in packages/workspace/src/browser/workspace-service.ts:188

`Protected` updateRoots

updateRoots(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:236

updateSchema

updateSchema(key, schema?): Promise<boolean>
Parameters
- key: string
  the property key under which to store the schema (e.g. tasks, launch)
- Optional schema: IJSONSchema
  the schema for the property. If none is supplied, the update is treated as a deletion.
Returns Promise<boolean>
- Defined in packages/workspace/src/browser/workspace-service.ts:725

`Protected` updateTitle

updateTitle(): void
Returns void
- Defined in packages/workspace/src/browser/workspace-service.ts:300

`Protected` updateWorkspace

updateWorkspace(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:231

`Protected` watchRoot

watchRoot(root): Promise<void>
Parameters
- root: FileStat
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:650

`Protected` watchRoots

watchRoots(): Promise<void>
Returns Promise<void>
- Defined in packages/workspace/src/browser/workspace-service.ts:631

`Protected` writeWorkspaceFile

writeWorkspaceFile(workspaceFile, workspaceData): Promise<undefined | FileStat>
Parameters
- workspaceFile: undefined | FileStat
- workspaceData: WorkspaceData
Returns Promise<undefined | FileStat>
- Defined in packages/workspace/src/browser/workspace-service.ts:474

Class WorkspaceService

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns WorkspaceService

Properties

Protected _ready

Protected _roots

Protected _workspace

Protected deferredRoots

Protected Readonly envVariableServer

Protected Readonly fileService

Protected Readonly fsPreferences

Protected Readonly labelProvider

Protected logger

Protected Readonly messageService

Protected Readonly onWorkspaceChangeEmitter

Protected Readonly onWorkspaceLocationChangedEmitter

Protected Readonly openHandlerContribution

Protected Readonly preferenceImpl

Protected preferences

Protected Readonly rootWatchers

Protected Readonly schemaProvider

Protected Readonly schemaUpdater

Protected Readonly server

Protected Readonly toDisposeOnWorkspace

Protected Readonly untitledWorkspaceService

Protected Readonly windowService

Protected Readonly windowTitleService

Protected Readonly workspaceFileService

Accessors

isMultiRootWorkspaceOpened

Returns boolean

onWorkspaceChanged

Returns Event<FileStat[]>

onWorkspaceLocationChanged

Returns Event<undefined | FileStat>

opened

Returns boolean

ready

Returns Promise<void>

roots

Returns Promise<FileStat[]>

saved

Returns boolean

workspace

Returns undefined | FileStat

Methods

addRoot

Parameters

Returns Promise<void>

areWorkspaceRoots

Parameters

Returns boolean

canHandle

Parameters

Returns Promise<boolean>

close

Returns Promise<void>

Protected computeRoots

Returns Promise<FileStat[]>

containsSome

Parameters

Returns Promise<boolean>

Protected doGetDefaultWorkspaceUri

Returns Promise<undefined | string>

Protected doInit

Returns Promise<void>

Protected doOpen

Parameters

Returns Promise<void>

Protected getDefaultWorkspaceUri

Returns MaybePromise<undefined | string>

Protected getExcludes

Parameters

`Protected` _ready

`Protected` _roots

`Protected` _workspace

`Protected` deferredRoots

`Protected` `Readonly` envVariableServer

`Protected` `Readonly` fileService

`Protected` `Readonly` fsPreferences

`Protected` `Readonly` labelProvider

`Protected` logger

`Protected` `Readonly` messageService

`Protected` `Readonly` onWorkspaceChangeEmitter

`Protected` `Readonly` onWorkspaceLocationChangedEmitter

`Protected` `Readonly` openHandlerContribution

`Protected` `Readonly` preferenceImpl

`Protected` preferences

`Protected` `Readonly` rootWatchers

`Protected` `Readonly` schemaProvider

`Protected` `Readonly` schemaUpdater

`Protected` `Readonly` server

`Protected` `Readonly` toDisposeOnWorkspace

`Protected` `Readonly` untitledWorkspaceService

`Protected` `Readonly` windowService

`Protected` `Readonly` windowTitleService

`Protected` `Readonly` workspaceFileService

`Protected` computeRoots

`Protected` doGetDefaultWorkspaceUri

`Protected` doInit

`Protected` doOpen

`Protected` getDefaultWorkspaceUri

`Protected` getExcludes

`Protected` getWorkspaceDataFromFile

`Protected` init

`Protected` isWorkspaceFile

`Protected` openNewWindow

`Protected` openWindow

`Protected` refreshRootWatchers

`Protected` reloadWindow

`Protected` setURLFragment

`Protected` setWorkspace

`Protected` shouldPreserveWindow

`Protected` toFileStat

`Protected` toValidRoot

`Protected` updateRoots