返回资讯中心
外部精选
软件工程
#开发者实时流

Datasette 通过 service worker 在浏览器中运行完整服务端 Python 应用

来源标题:Full server-side Datasette Python app in the browser with service workers

Datasette 现在可以借助 service worker 在浏览器中完整运行服务端 Python 应用,通过 lite.datasette.io 的 URL 参数即可安装插件并加载数据库。例如传入 ?install=datasette-maplibre 安装地图插件,再用 &url= 加载托管于 Gist 的 SQLite 数据库(需开放 CORS 响应头),&metadata= 加载元数据文件。地址栏中的 hash 片段还可直接定位到具体页面。

Hacker News 最新simonw2026/11/17 · 今天12 分钟阅读

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

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 文件。该元数据文件为各个表以及 Datasette 首页添加 HTML 描述。访问那个首页可以看到该插件其他功能的引导式介绍,这些功能全部定义在元数据文件中。

#/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——我在那里发了一条评论,用 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

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/<session>/ 前缀是必要的,因为要支持多个标签页。

考虑上面的 URL,它加载了带 datasette-maplibre 插件的演示实例。那个 URL 定义了一个完整的、自定义的 Datasette 实例。你可能在一个标签页里运行它,同时在另一个标签页里运行我的另一个演示链接。

lite.datasette.io 的 service worker 在所有那些标签页之间共享。如果它路由到单个 Datasette 实例,那么每个标签页都会共享那个底层实例,无论它们的 URL 试图配置什么插件或其他设置。

因此,父页面会生成一个随机 session ID,并将其用作所有后续隐藏资源和页面加载的前缀。service worker 随后可以用这个 session ID 将这些请求通过父页面路由回一个 web worker,该 worker 为这个特定 session 运行一个专用的 Datasette 实例。

(我们仍然需要 web worker,因为 service worker 中的 Pyodide 无法将状态维持超过大约 30 秒,具体取决于浏览器。这里有很多活动部件!)

我让 Claude Fable 5.2 生成了几张 SVG 图来帮助解释这一点。这是我最喜欢的一张,现在已经嵌入到 Datasette Lite README 中:

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

打开原文
去社区讨论 →