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

`.ts` 是推荐使用的前端脚本源码形式，运行目标是浏览器端。开发者可以用 TypeScript 语法编写页面、应用、项目或系统级的个性化逻辑，系统会在运行前编译为浏览器可执行的 JavaScript。

前端 `.ts` 脚本常用于页面组件交互、页面级工具函数、应用级公共逻辑、系统或项目级钩子脚本。页面级脚本通常与页面元数据同目录并同名，例如 `order.spg` 对应 `order.spg.ts`；应用或项目级钩子脚本通常使用 `custom.ts`。

## 常见位置{#locations}

| 位置 | 说明 |
| --- | --- |
| `/{project}/app/{app}.app/custom.ts` | 应用级前端脚本，作用于应用内用户页面。 |
| `/{project}/public/custom.ts` | 项目级前端脚本，作用于项目内用户页面。 |
| `/sysdata/public/custom.ts` | 系统级前端脚本，作用于系统页面或全局页面。 |
| `*.spg.ts`、`*.dash.ts`、`*.rpt.ts`、`*.fapp.ts` | 页面或资源关联的前端脚本，通常与对应元数据文件同目录。 |

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

1. 优先维护 `.ts` 源文件，不要同时手工改同名 `.js` 编译产物。
2. `.ts` 面向浏览器运行，不能直接使用后端 Rhino、JVM 或服务器专用 API。
3. 被 `.html` 或 `.ftl` 页面加载的同目录脚本，需要确认最终加载路径，可参考 [HTML 和 FTL 自定义页面](../../../script/frontend/html-ftl-pages.md)。
4. 引用元数据结构时，先阅读对应文件类型页和 DTS，避免只按字段名猜测。
5. 修改后需要在浏览器端验证页面加载、交互动作和控制台错误。

## 相关参考{#references}

- [脚本开发](../../../script/README.md)
- [脚本文件的组织](../../../script/file-organization.md)
- [HTML 和 FTL 自定义页面](../../../script/frontend/html-ftl-pages.md)
- [`types/api/succ.bo.d.ts`](../../../../../dev-types/types/api/succ.bo.d.ts)