The options for creating a file browser using a file browser factory.


In future versions of JupyterLab, some of these options may disappear, which is a backward-incompatible API change and will necessitate a new version release. This is because in future versions, there will likely be an application-wide notion of a singleton command registry and a singleton state database.


  • IOptions


auto?: boolean

Whether a file browser automatically loads its initial path.


The default is true.

driveName?: string

An optional Contents.IDrive name for the model. If given, the model will prepend driveName: to all paths used in file operations.

refreshInterval?: number

The time interval for browser refreshing, in ms.

restore?: boolean

Whether a file browser automatically restores state when instantiated. The default is true.


The file browser model will need to be restored before for the file browser to start saving its state.

state?: IStateDB<ReadonlyPartialJSONValue>

The state database to use for saving file browser state and restoring it.


Unless the value null is set for this option, the application state database will be automatically passed in and used for state restoration.

Generated using TypeDoc