文档章节
JavaScript 函数
用这些函数处理 JavaScript 与 TypeScript 文件。
本章导读
js 命名空间下有三个函数,都接收 assets/ 目录里的资源、返回一个资源(resource.Resource),区别在用哪条工具链、解决什么问题:
js.Build:内嵌 esbuild,打包 + 转译(TS/JSX)+ 摇树 + 压缩,支持@params注入模板数据。绝大多数场景用它。js.Babel:调用项目里安装的 Babel CLI,按babel.config的 preset/插件转译语法;需要 Node.js,且要把babel加入security.exec.allow。js.Batch:注册「组 / 脚本 / 实例 / runner」后统一构建,支持全局代码分割,适合「同一组件多次出现、参数不同」的场景。
三者都不做内容的网络请求,产物最终都要由你在模板里输出 <script src="{{ .RelPermalink }}">。
读完本章你应该能够
- 按需求选对函数:单入口打包用
js.Build,Babel preset 链用js.Babel,多实例 + 代码分割用js.Batch; - 用
targetPath、minify、sourceMap、params、externals、defines等选项把产物调成需要的样子; - 在生产环境配合
fingerprint输出 SRI 与带指纹的文件名; - 分辨三类报错:
type … not supported in Resource transformations(输入不是资源)、Could not resolve …(导入路径错)、access denied … not whitelisted(外部可执行文件没进安全白名单)。