Class ContentsManager

constructor

• new ContentsManager(options?): ContentsManager

• Construct a new contents manager object.

  Parameters

  • Optional options: ContentsManager.IOptions

    The options used to initialize the object.

  Returns ContentsManager

Readonly serverSettings

fileChanged

• get fileChanged(): ISignal<this, Contents.IChangedArgs>

• A signal emitted when a file operation takes place.

  Returns ISignal<this, Contents.IChangedArgs>

isDisposed

• get isDisposed(): boolean

• Test whether the manager has been disposed.

  Returns boolean

addDrive

• addDrive(drive): void

• Add an IDrive to the manager.

  Parameters

  • drive: IDrive

  Returns void

copy

• copy(fromFile, toDir): Promise<Contents.IModel>

• Copy a file into a given directory.

  Parameters

  • fromFile: string

  • toDir: string

    The destination directory path.

  Returns Promise<Contents.IModel>

  A promise which resolves with the new contents model when the file is copied.

  Notes

  The server will select the name of the copied file.

createCheckpoint

• createCheckpoint(path): Promise<ICheckpointModel>

• Create a checkpoint for a file.

  Parameters

  • path: string

    The path of the file.

  Returns Promise<ICheckpointModel>

  A promise which resolves with the new checkpoint model when the checkpoint is created.

delete

• delete(path): Promise<void>

• Delete a file.

  Parameters

  • path: string

    The path to the file.

  Returns Promise<void>

  A promise which resolves when the file is deleted.

deleteCheckpoint

• deleteCheckpoint(path, checkpointID): Promise<void>

• Delete a checkpoint for a file.

  Parameters

  • path: string

    The path of the file.

  • checkpointID: string

    The id of the checkpoint to delete.

  Returns Promise<void>

  A promise which resolves when the checkpoint is deleted.

dispose

• dispose(): void

• Dispose of the resources held by the manager.

  Returns void

driveName

• driveName(path): string

• Given a path of the form drive:local/portion/of/it.txt get the name of the drive. If the path is missing a drive portion, returns an empty string.

  Parameters

  • path: string

  Returns string

  The drive name for the path, or the empty string.

get

• get(path, options?): Promise<Contents.IModel>

• Get a file or directory.

  Parameters

  • path: string

  • Optional options: IFetchOptions

  Returns Promise<Contents.IModel>

  A promise which resolves with the file content.

getDownloadUrl

• getDownloadUrl(path): Promise<string>

• Get an encoded download url given a file path.

  Parameters

  • path: string

    An absolute POSIX file path on the server.

    Notes

    It is expected that the path contains no relative paths.

    The returned URL may include a query parameter.

  Returns Promise<string>

getSharedModelFactory

• getSharedModelFactory(path): ISharedFactory

• Given a path, get a shared model factory from the relevant backend. Returns null if the backend does not provide one.

  Parameters

  • path: string

  Returns ISharedFactory

listCheckpoints

• listCheckpoints(path): Promise<ICheckpointModel[]>

• List available checkpoints for a file.

  Parameters

  • path: string

    The path of the file.

  Returns Promise<ICheckpointModel[]>

  A promise which resolves with a list of checkpoint models for the file.

localPath

• localPath(path): string

• Given a path of the form drive:local/portion/of/it.txt get the local part of it.

  Parameters

  • path: string

  Returns string

  The local part of the path.

newUntitled

• newUntitled(options?): Promise<Contents.IModel>

• Create a new untitled file or directory in the specified directory path.

  Parameters

  • Optional options: Contents.ICreateOptions

  Returns Promise<Contents.IModel>

  A promise which resolves with the created file content when the file is created.

normalize

• normalize(path): string

• Normalize a global path. Reduces '..' and '.' parts, and removes leading slashes from the local part of the path, while retaining the drive name if it exists.

  Parameters

  • path: string

  Returns string

  The normalized path.

rename

• rename(path, newPath): Promise<Contents.IModel>

• Rename a file or directory.

  Parameters

  • path: string

    The original file path.

  • newPath: string

    The new file path.

  Returns Promise<Contents.IModel>

  A promise which resolves with the new file contents model when the file is renamed.

resolvePath

• resolvePath(root, path): string

• Resolve a global path, starting from the root path. Behaves like posix-path.resolve, with 3 differences:

  • will never prepend cwd
  • if root has a drive name, the result is prefixed with ":"
  • before adding drive name, leading slashes are removed

  Parameters

  • root: string

  • path: string

  Returns string

  The normalized path.

restoreCheckpoint

• restoreCheckpoint(path, checkpointID): Promise<void>

• Restore a file to a known checkpoint state.

  Parameters

  • path: string

    The path of the file.

  • checkpointID: string

    The id of the checkpoint to restore.

  Returns Promise<void>

  A promise which resolves when the checkpoint is restored.

save

• save(path, options?): Promise<Contents.IModel>

• Save a file.

  Parameters

  • path: string

    The desired file path.

  • Optional options: Partial<Contents.IModel>

    Optional overrides to the model.

  Returns Promise<Contents.IModel>

  A promise which resolves with the file content model when the file is saved.

  Notes

  Ensure that model.content is populated for the file.