返回资讯中心
外部精选
ai-models
#LLM#工程实践#javascript#projects#python#urls

Datasette Lite 用 Service Worker 重写,可在浏览器运行完整服务端应用

来源标题:Running the full server-side Datasette Python app in the browser with service workers and Pyodide

Datasette 作者 Simon Willison 用 service workers 完全重写了 Datasette Lite,使其在浏览器中运行的效果几乎与真正的服务端应用无异。新版通过 lite.datasette.io 的特定 URL 可加载 SQLite、JSON、CSV 等数据,选择 Datasette 版本、GitHub 分支或提交,从 100 多个 SQLite 版本中挑选,并安装 PyPI 插件。

Simon Willison2026/11/17 · 今天25 分钟阅读

以下正文由 AI 翻译自 Simon Willison(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Datasette Lite 是我将 Datasette Python 应用移植到浏览器中直接运行的版本,基于 WebAssembly 和 Pyodide 实现。我发布了一个使用 service worker 完全重写的 Datasette Lite,现在它几乎与真正的服务端应用没有区别。

现在,你可以通过精心构造的 URL 访问 lite.datasette.io,完成以下所有操作:

  • 加载客户端 Datasette,浏览任意 SQLite 数据库、JSON 文件、CSV 文件或 SQL 脚本
  • 从 PyPI 选择加载某个已发布的 Datasette 版本
  • 从 Datasette GitHub 仓库加载特定的 commit、tag 或分支名
  • 从 100 多个 SQLite 版本中选择一个与 Datasette 配合使用
  • 从 PyPI 或 wheel 文件 URL 安装额外的 Datasette 插件,包括 JavaScript 可视化工具

能够加载特定的 Datasette 引用、插件和 SQLite 版本,使得它成为一个极佳的工具,可以用来链接到进行中功能或 bug 复现的演示,而无需启动一个完整的 Web 服务器来提供该演示。

举个例子,考虑以下 URL: https://lite.datasette.io/?install=datasette-maplibre&url=https://gist.githubusercontent.com/simonw/39fa5d399465766039549912e2b3d291/raw/f6dfba99a75cbb8b5d9386223220eb52272767ee/demo.db&metadata=https://gist.githubusercontent.com/simonw/39fa5d399465766039549912e2b3d291/raw/f6dfba99a75cbb8b5d9386223220eb52272767ee/metadata.yml#/demo/capitals_and_countries%23map=0/4.2/180&color=continent 打开该链接,经过短暂的加载界面后,你会看到一个类似这样的页面: 这是 Datasette 运行着新的 datasette-maplibre 插件,加载了一个包含各国 GeoJSON 形状的数据库,并在表格中同时显示了一张组合地图和各个边界地图。 让我们拆解一下这个 URL,看看它在做什么:

https://lite.datasette.io/
  ?install=datasette-maplibre
  &url=https://.../demo.db
  &metadata=https://.../metadata.yml
  #/demo/capitals_and_countries%23map=0/4.2/180&color=continent

?install=datasette-maplibre 会从 PyPI 安装该额外插件。你可以根据需要多次传入 &install=... 来加载更多插件。 &url=https://.../demo.db 会从提供的 URL 加载该 SQLite 数据库。这些 URL 需要具有开放的 CORS 头——我把这类文件托管在 Gist 上,因为 Gist 提供了一种简单的方式,让 Web 托管的文件具有开放的 CORS 头。 &metadata=https://.../metadata.yml 会加载这个 metadata.yml 文件。该 metadata 文件为各个表以及 Datasette 首页添加了 HTML 描述。访问该首页可以查看该插件其他功能的引导介绍,这些功能全部在 metadata 文件中定义。 #/demo/capitals_and_countries%23map=0/4.2/180&color=continent 是一个片段哈希,会转换为 Datasette 内的一个位置——这里它会加载 /demo/capitals_and_countries SQL 视图,然后向其追加另一个片段哈希(%23 是 URL 编码的 #),告诉地图插件缩放到特定位置,并根据数据中的 continent 列设置地图上形状的颜色。 那个 URL 做了很多工作!去年我在 URL-addressable Pyodide Python environments 一文中,更详细地写了这种构建 URL 可寻址软件的技巧。 支持的完整 URL 参数集合在 Datasette Lite README 中有描述。 我已经开始将 Datasette Lite 作为 Datasette 开发流程的一部分来使用。这里有一个最近描述分页 bug 的 issue——我在那里发表了一条评论,用 Datasette Lite 的链接演示了旧的、有问题的行为以及新的修复: 该 bug 的演示:https://lite.datasette.io/?ref=1.0a42&sql=https://gist.github.com/simonw/75ececf61d50e6e8d50f0c150150ee81#/data/scores?_size=2&_sort=score ——点击下一页,第二页是空的。 这是同一个页面在 bug 修复后的效果(运行在 1.0a43 上):https://lite.datasette.io/?ref=1.0a43&sql=https://gist.github.com/simonw/75ececf61d50e6e8d50f0c150150ee81#/data/scores?_size=2&_sort=score

这是如何工作的,使用 service worker

Datasette Lite 并不是一个新项目。我在 2022 年发布了第一个版本,最初多少有点玩笑性质(在浏览器中运行服务端应用相当有趣),但它很快就开始证明了自己的价值。 最初那个版本的问题在于它是一个 hack。它的工作方式是在一个 Pyodide web worker 中运行 Datasette,通过该技术栈模拟请求,然后使用 innerHTML 将生成的 HTML 注入回顶层页面。 这对基本的 Datasette 有效,但意味着任何使用 JavaScript 的功能都无法工作,因为 innerHTML 中的 script 标签不会执行,而且它使用的 web worker 技巧也无法加载额外的 JavaScript 或 CSS 文件。 新版本采用了基于 Service Worker 的完全不同的方法。Service Worker 允许 JavaScript 拦截对新页面和资源的 HTTP 请求,并从客户端代码中提供响应。 Datasette Lite 为整个 lite.datasette.io 域注册了一个 service worker。然后父页面创建一个 iframe,将 Datasette 页面的请求发送到如下形式的 URL:

/app/aa94e6851595/ # 首页 (HTML)
/app/aa94e6851595/data/places # 表格页面 (HTML)
/app/aa94e6851595/-/static/navigation-search.js # (JavaScript)
/app/aa94e6851595/-/static/app.css # (CSS)

这些是常规的 Datasette URL,但带有 /app/aa94e6851595/ 前缀。这是怎么回事? /app// 前缀是必要的,因为有多个标签页。 考虑上面的 URL,它加载了带有 datasette-maplibre 插件的演示实例。该 URL 定义了一个完整的、自定义的 Datasette 实例。你可能在一个标签页中运行着那个实例,然后在另一个标签页中运行我的另一个演示链接。 lite.datasette.io 的 service worker 在所有那些标签页之间共享。如果它路由到单个 Datasette 实例,那么每个标签页都会共享那个底层实例,无论它们的 URL 试图配置什么插件或其他设置。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →