Interface IDocumentManager

The interface for a document manager.

Hierarchy

Properties

activateRequested: ISignal<IDocumentManager, string>

A signal emitted when one of the documents is activated.

autosave: boolean

Whether to autosave documents.

autosaveInterval: number

Determines the time interval for autosave in seconds.

confirmClosingDocument: boolean

Whether to ask confirmation to close a tab or not.

isDisposed: boolean

Test whether the object has been disposed.

Notes

This property is always safe to access.

lastModifiedCheckMargin: number

Defines max acceptable difference, in milliseconds, between last modified timestamps on disk and client.

The registry used by the manager.

renameUntitledFileOnSave: boolean

Whether to ask the user to rename untitled file on first manual save.

The service manager used by the manager.

stateChanged: ISignal<IDocumentManager, IChangedArgs<any, any, string>>

Signal triggered when an attribute changes.

Methods

  • Close all of the open documents.

    Returns Promise<void>

    A promise resolving when the widgets are closed.

  • Close the widgets associated with a given path.

    Parameters

    • path: string

      The target path.

    Returns Promise<void>

    A promise resolving when the widgets are closed.

  • Get the document context for a widget.

    Parameters

    • widget: Widget

      The widget of interest.

    Returns DocumentRegistry.Context

    The context associated with the widget, or undefined if no such context exists.

  • Copy a file.

    Parameters

    • fromFile: string

      The full path of the original file.

    • toDir: string

      The full path to the target directory.

    Returns Promise<Contents.IModel>

    A promise which resolves to the contents of the file.

  • Create a new file and return the widget used to view it.

    Parameters

    • path: string

      The file path to create.

    • Optional widgetName: string

      The name of the widget factory to use. 'default' will use the default widget.

    • Optional kernel: Partial<Kernel.IModel>

      An optional kernel name/id to override the default.

    Returns Widget

    The created widget, or undefined.

    Notes

    This function will return undefined if a valid widget factory cannot be found.

  • Delete a file.

    Parameters

    • path: string

      The full path to the file to be deleted.

    Returns Promise<void>

    A promise which resolves when the file is deleted.

    Notes

    If there is a running session associated with the file and no other sessions are using the kernel, the session will be shut down.

  • Dispose of the resources held by the object.

    Notes

    If the object's dispose method is called more than once, all calls made after the first will be a no-op.

    Undefined Behavior

    It is undefined behavior to use any functionality of the object after it has been disposed unless otherwise explicitly noted.

    Returns void

  • Duplicate a file.

    Parameters

    • path: string

      The full path to the file to be duplicated.

    Returns Promise<Contents.IModel>

    A promise which resolves when the file is duplicated.

  • See if a widget already exists for the given path and widget name.

    Parameters

    • path: string

      The file path to use.

    • Optional widgetName: string

      The name of the widget factory to use. 'default' will use the default widget.

    Returns IDocumentWidget<Widget, DocumentRegistry.IModel>

    The found widget, or undefined.

    Notes

    This can be used to find an existing widget instead of opening a new widget.

  • Open a file and return the widget used to view it.

    Parameters

    • path: string

      The file path to open.

    • Optional widgetName: string

      The name of the widget factory to use. 'default' will use the default widget.

    • Optional kernel: Partial<Kernel.IModel>

      An optional kernel name/id to override the default.

    • Optional options: IOpenOptions

    Returns IDocumentWidget<Widget, DocumentRegistry.IModel>

    The created widget, or undefined.

    Notes

    This function will return undefined if a valid widget factory cannot be found.

  • Open a file and return the widget used to view it. Reveals an already existing editor.

    Parameters

    • path: string

      The file path to open.

    • Optional widgetName: string

      The name of the widget factory to use. 'default' will use the default widget.

    • Optional kernel: Partial<Kernel.IModel>

      An optional kernel name/id to override the default.

    • Optional options: IOpenOptions

    Returns IDocumentWidget<Widget, DocumentRegistry.IModel>

    The created widget, or undefined.

    Notes

    This function will return undefined if a valid widget factory cannot be found.

  • Overwrite a file.

    Parameters

    • oldPath: string

      The full path to the original file.

    • newPath: string

      The full path to the new file.

    Returns Promise<Contents.IModel>

    A promise containing the new file contents model.

  • Rename a file or directory.

    Parameters

    • oldPath: string

      The full path to the original file.

    • newPath: string

      The full path to the new file.

    Returns Promise<Contents.IModel>

    A promise containing the new file contents model. The promise will reject if the newPath already exists. Use [[overwrite]] to overwrite a file.

Generated using TypeDoc