配置浏览器存储#

默认情况下，JupyterLite 使用用户的浏览器存储来存储设置和站点首选项。

设置存储#

默认情况下，用户在同一域上的所有设置都将对托管在该域上的所有 JupyterLite 实例可用。要创建单独的设置存储，请将 jupyter-lite.json#jupyter-config-data/settingsStorageName 从默认的 JupyterLite Storage - <baseUrl> 更改。

默认情况下，将使用最佳可用的持久存储驱动程序。可以使用 jupyter-lite.json#jupyter-config-data/settingsStorageDrivers 强制尝试特定的驱动程序集。有关 本地存储驱动程序 的更多信息。

本地存储驱动程序#

默认情况下，将从用户浏览器中可用的技术中选择“最佳” localForage 驱动程序。

要强制从特定技术集中选择，可以指定 settingsStorageDrivers 和 contentsStorageDrivers，其中将选择第一个与浏览器兼容的驱动程序。

配置值

技术

持久性？

注意

asyncStorage

IndexedDB

是

通常是选中的那个

webSQLStorage

WebSQL

是

localStorageWrapper

localStorage

是

memoryStorageDriver

内存中

否

需要 enableMemoryStorage

其他

未知

未知

可能由第三方扩展添加

易失性内存存储#

许多扩展和功能要求至少能够“认为”它们正在保存和加载内容和设置。如果由于浏览器安全设置无法存储用户数据，JupyterLite 应用程序通常会无法完全初始化：虽然这可能会令人沮丧，但丢失用户独特的创建数据会“更”令人沮丧。

警告

如果持久性“完全”在 JupyterLite 之外处理，例如在嵌入式 repl 中，则可以禁用所有持久性，确保每次页面/iframe 重新加载后“完全丢失用户数据”

  • 将 enableMemoryStorage 设置为 true

  • 将 contentsStorageDrivers 和 settingsStorageDrivers 设置为 ["memoryStorageDriver"]