Construct a new JupyterLab object.
ReadonlycommandThe command linker used by the application.
ReadonlycommandsThe application command registry.
ReadonlycontextThe application context menu.
ReadonlydocThe document registry instance used by the application.
ReadonlynameThe name of the JupyterLab application.
ReadonlynamespaceA namespace/prefix plugins may use to denote their provenance.
ProtectedpluginApplication plugin registry.
ReadonlyregisterA list of all errors encountered when registering plugins.
ReadonlyrestoredPromise that resolves when state is first restored, returning layout description.
ReadonlyserviceThe service manager used by the application.
ReadonlyshellReadonlystatusThe application busy and dirty status signals and flags.
ReadonlyversionThe version of the JupyterLab application.
The list of all the deferred plugins.
The JupyterLab application information dictionary.
The JupyterLab application paths dictionary.
ProtectedaddProtectedattachWalks up the DOM hierarchy of the target of the active contextmenu
event, testing each HTMLElement ancestor for a user-supplied function. This can
be used to find an HTMLElement on which to operate, given a context menu click.
a function that takes an HTMLElement and returns a
boolean for whether it is the element the requester is seeking.
an HTMLElement or undefined, if none is found.
Deactivate the plugin and its downstream dependents if and only if the
plugin and its dependents all support deactivate.
The ID of the plugin of interest.
A list of IDs of downstream plugins deactivated with this one.
ProtectedevtA method invoked on a document 'contextmenu' event.
ProtectedevtOverride keydown handling to prevent command shortcuts from preventing user input.
This introduces a slight delay to the command invocation, but no delay to user input.
ProtectedevtA method invoked on a document 'keyup' event.
The default implementation of this method invokes the key up processing method of the application command registry.
A subclass may reimplement this method as needed.
ProtectedevtRegister a plugin with the application.
Register plugins from a plugin module.
The plugin module to register.
Register the plugins from multiple plugin modules.
The plugin modules to register.
Register multiple plugins with the application.
Resolve an optional service of a given type.
A promise which resolves to an instance of the requested
service, or null if it cannot be resolved.
Services are singletons. The same instance will be returned each time a given service token is resolved.
If the plugin which provides the service has not been activated, resolving the service will automatically activate the plugin.
User code will not typically call this method directly. Instead, the optional services for the user's plugins will be resolved automatically when the plugin is activated.
Resolve a required service of a given type.
A promise which resolves to an instance of the requested service, or rejects with an error if it cannot be resolved.
Services are singletons. The same instance will be returned each time a given service token is resolved.
If the plugin which provides the service has not been activated, resolving the service will automatically activate the plugin.
User code will not typically call this method directly. Instead, the required services for the user's plugins will be resolved automatically when the plugin is activated.
Start the application.
Optionaloptions: IStartOptionsThe options for starting the application.
A promise which resolves when all bootstrapping work is complete and the shell is mounted to the DOM.
This should be called once by the application creator after all initial plugins have been registered.
If a plugin fails to the load, the error will be logged and the other valid plugins will continue to be loaded.
Bootstrapping the application consists of the following steps:
JupyterLab is the main application class. It is instantiated once and shared.