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

`.action` 是服务器端直接加载的 JavaScript/Rhino 脚本文件，常见于旧资源兼容或 `.action.ts` 编译后的运行形式。新开发推荐维护 `.action.ts`，让系统完成编译和类型辅助。

如果直接维护 `.action` 文件，脚本必须遵守 Rhino 支持的 JavaScript 语法要求。不要使用 Rhino 不支持的现代 JavaScript 或 TypeScript 语法，例如类型标注、较新的 ECMAScript 特性、浏览器专用对象等。

## 常见位置{#locations}

| 位置 | 说明 |
| --- | --- |
| `*.action` | 旧版或兼容形式的后端脚本。 |
| `hooks.action` | 系统、项目或应用级后端钩子脚本的兼容形式。 |
| `API/*.action` | 应用 API 目录下的后端脚本兼容形式。 |

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

1. 有同名 `.action.ts` 时，以 `.action.ts` 为源码入口，不建议手工修改 `.action`。
2. 直接写 `.action` 时，需要按 Rhino 的语法能力编写，避免使用现代浏览器或 Node.js 才支持的语法和 API。
3. `.action` 运行在 JVM 服务器端，不是浏览器脚本，也不是 Node.js 脚本。
4. 修改后需要在测试环境调用对应接口、流程或钩子场景验证。

## 相关参考{#references}

- [.action.ts 后端脚本文件](./action-ts.md)
- [脚本开发](../../../script/README.md)
- [脚本文件的组织](../../../script/file-organization.md)