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

`.action.ts` 是推荐使用的后端脚本源码形式。它使用 TypeScript 语法编写，系统会编译为 Rhino 可执行的 JavaScript，并在服务器 JVM 环境中运行。

后端脚本常用于程序流脚本、自定义接口、数据加工脚本、系统事件监听、项目或应用级钩子逻辑。与前端 `.ts` 不同，`.action.ts` 面向服务器端执行，可以使用后端脚本 API，但不能依赖浏览器 DOM、Window、页面组件实例等前端对象。

## 常见位置{#locations}

| 位置 | 说明 |
| --- | --- |
| `/sysdata/settings/hooks.action.ts` | 系统级后端钩子脚本。 |
| `/{project}/settings/hooks.action.ts` | 项目级后端钩子脚本。 |
| `/{project}/app/{app}.app/hooks.action.ts` | 应用级后端钩子脚本。 |
| `/{project}/app/{app}.app/API/*.action.ts` | 应用 API 目录下的后端脚本。 |
| `*.tbl.action.ts` | 与数据模型关联的后端脚本。 |

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

1. 优先维护 `.action.ts`，不要同时手工改同名 `.action` 编译产物。
2. 后端脚本运行在服务器端，多线程并发场景下不要依赖全局变量保存请求状态。
3. 需要返回页面、JSON、文件或调用程序流时，先确认调用方对返回值结构的要求。
4. 后端脚本无法按浏览器方式断点调试，通常通过日志和测试环境验证。

## 相关参考{#references}

- [脚本开发](../../../script/README.md)
- [脚本文件的组织](../../../script/file-organization.md)
- [`types/api/succ.dw.d.ts`](../../../../../dev-types/types/api/succ.dw.d.ts)
- [`types/api/succ.afl.d.ts`](../../../../../dev-types/types/api/succ.afl.d.ts)