---
title: .js 前端脚本文件
navTitle: .js
---
# .js 前端脚本文件

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

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

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

## 常见位置{#locations}

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

## 编辑注意事项{#notes}

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

## 相关参考{#references}

- [.ts 前端脚本文件](./ts.md)
- [脚本开发](../../../script/README.md)
- [脚本文件的组织](../../../script/file-organization.md)
- [HTML 和 FTL 自定义页面](../../../script/frontend/html-ftl-pages.md)