配置浏览器存储#

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

设置存储#

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

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

本地存储驱动程序#

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

要强制从特定技术集中进行选择,可以指定 settingsStorageDriverscontentsStorageDrivers,并选择第一个与浏览器兼容的驱动程序。

配置值

技术

持久化?

注意

asyncStorage

IndexedDB

通常是选定的那个

webSQLStorage

WebSQL

localStorageWrapper

localStorage

memoryStorageDriver

内存中

需要 enableMemoryStorage

其他

未知

未知

可能由第三方扩展添加

易失性内存存储#

许多扩展和功能都需要能够至少假装保存和加载内容和设置。如果由于浏览器安全设置导致用户数据无法存储,JupyterLite 应用程序通常无法完全初始化:虽然这可能令人沮丧,但丢失用户独特的创作数据更加令人沮丧。

警告

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

  • enableMemoryStorage 设置为 true

  • contentsStorageDriverssettingsStorageDrivers 设置为 ["memoryStorageDriver"]