web.send_file

web.send_file

AI 原文

web.send_file

功能

直接把本地文件作为 HTTP 响应发送，适合下载大文件或导出文件，避免把文件内容一次性读入 BT 动态响应字符串。

语法

参数

参数类型必填默认值说明
pathString/Fs是无要发送的本地文件路径。相对路径基于当前源码文件目录解析，@/ 基于项目根解析。

返回值

类型说明
Bool设置成功返回 true；请求结束时由 Web 层发送文件。

示例

注意事项

  • 只能在 Web 请求中调用。
  • 该能力会读取本地文件，受 BT_PERMISSION_DENY=fs / BT_PERMISSION_ALLOW 权限配置约束。
  • 文件响应会由 Web 框架分块发送，支持 ETag、Last-Modified、条件请求和 HTTP Range。
  • web.send_file() 设置后，本次请求不会写回最后表达式或 print 产生的动态响应体。
  • Content-Type 默认按文件扩展名推断；需要覆盖时可提前调用 web.header('Content-Type', value)。