.js 前端脚本文件

.js 是浏览器端直接执行的 JavaScript 文件，通常可以看作 .ts 前端脚本的编译产物。日常开发推荐直接维护 .ts 文件，让系统完成编译和类型检查。

如果直接维护 .js，可以省去 TypeScript 编译时间，适合极少数对编译耗时敏感、逻辑非常简单或需要兼容旧资源的场景。但直接写 .js 会失去 TypeScript 的类型辅助和部分高级语法转换能力，开发者需要自行关注目标浏览器的语法兼容性。

页面级前端脚本运行时按 .js 地址加载。系统会优先查找同名 .ts 并使用其编译结果；只有同名 .ts 不存在时，才把同名 .js 作为直接维护的脚本使用。如果需要从 .html 或 .ftl 页面加载脚本，参考 HTML 和 FTL 自定义页面。

常见位置

位置	说明
custom.js	custom.ts 的浏览器端脚本形式或兼容脚本。
*.spg.js、*.dash.js、*.rpt.js	页面或资源关联的前端 JavaScript 脚本。
public/ 下的 .js	公开访问的浏览器端脚本资源。

编辑注意事项

1. 同名 .ts 存在时，以 .ts 为源码入口，不建议手工修改 .js。
2. 直接写 .js 时，不要使用目标浏览器不支持的现代 JavaScript 语法。
3. 需要类型提示、模块导入和较复杂逻辑时，优先改用 .ts。
4. 修改后在浏览器 DevTools 中检查加载结果和控制台错误。

相关参考

• .ts 前端脚本文件
• 脚本开发
• 脚本文件的组织
• HTML 和 FTL 自定义页面