Datasette 1.0a43 的重点是输出渲染器的流式支持、安全修复,以及基于 CSS 的跨文档视图过渡。此次更新后,1.0 里程碑的完成进度达到 53%。
面向关注数据工具与 Web 开发的写好标智库读者,本文按导出接口、安全边界和页面交互三个方向梳理这次更新。
输出渲染器支持流式响应
本次面向 1.0 的主要改动,是为输出渲染器加入流式支持:
- 内置 TSV、CSV 导出已采用这一机制。
- 插件可以声明自身支持流式输出。
- 新增
Response.stream()方法,支持在一次响应中流式输出表内全部行。
对于输出渲染器插件的开发者来说,流式输出是此次值得关注的接口变化。
安全修复:私有查询信息可能泄露
本次包含多项安全修复,其中一项涉及私有存储查询的信息暴露,并已发布安全公告。
该问题可能导致查询标题与 SQL 内容被读取,但不会允许访问者执行该查询。
这里需要区分两个权限边界:
- 信息可见性:访问者能否读取查询标题和 SQL。
- 查询执行权限:访问者能否运行该查询。
此次问题涉及前者,不能将其理解为访问者可以直接执行私有查询。
行页面与插件接口改进
围绕行页面、复制操作和插件开发,本次还包括以下更新:
- 调整行页面的 JSON 表示,为 1.0 做准备。
- 新增
<datasette-copy-button>Web Component,在多处提供数据库结构复制功能。 - 行页面中的 JSON 列内容支持格式化显示。
- 新增 JavaScript 工具方法
DatasetteModal.confirm()。 - 修复数十项问题。
用 CSS 改善多页导航体验
Datasette 仍然是多页应用。新增的跨文档视图过渡并未改变这一架构,而是让页面间导航在视觉上更接近单页应用。
关键 CSS 如下:
/* 仅在用户未要求减少动态效果时启用跨文档视图过渡 */ @media (prefers-reduced-motion: no-preference) { @view-transition { navigation: auto; } } /* 让分面结果区域在新旧位置之间过渡 */ html:active-view-transition .content > .facet-results { view-transition-name: facet-results; } /* 为包含数据表格的容器设置过渡名称 */ html:active-view-transition .table-wrapper:has(> table.rows-and-columns) { view-transition-name: rows-table; } 这段实现可以分为两部分:
- 启用跨文档过渡:通过
@view-transition中的navigation: auto开启导航过渡,并用prefers-reduced-motion尊重用户的减少动态效果偏好。 - 指定参与过渡的区域:为分面结果和表格容器设置
view-transition-name,让对应区域参与页面切换动画。
需要注意,这属于导航体验的增强,不代表 Datasette 已改为单页应用。
浏览器兼容性需区分现状与预期
该版本说明称,Safari 和 Chrome 已可使用这一效果;Firefox 162 则被预计将于 2026 年 12 月 8 日加入支持。
后者是预期时间,并非已经完成的兼容性确认。实际采用时,应以目标浏览器版本的支持情况为准。

