# @darkroom\.engineering/tempus 中文文档

规范地址：https://npmcn.com/package/%40darkroom.engineering/tempus/

版本：0\.0\.46
npm 元数据更新时间：2025-01-20T23:37:21.475Z
中文译文更新时间：2026-11-11T11:56:11.326Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40darkroom.engineering/tempus
原文对照：https://npmcn.com/package/%40darkroom.engineering/tempus/?lang=original
项目主页：https://github.com/darkroomengineering/tempus
源码仓库：https://github.com/darkroomengineering/tempus

弃用说明：The '@darkroom\.engineering/tempus' package has been renamed to 'tempus'\. Please update your dependencies: npm install tempus and visit the documentation: https://www\.npmjs\.com/package/tempus

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：13.5 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-04-17T21:20:31.221Z
- 最新版本发布：2024-04-17T22:02:48.584Z
- 近 30 天下载量：173471（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

一个RAF来统治他们

## 安装

```sh
npm install @darkroom.engineering/tempus
```

也可以使用：`pnpm add @darkroom.engineering/tempus`、`yarn add @darkroom.engineering/tempus`、`bun add @darkroom.engineering/tempus`

## README

[![TEMPUS](https://assets.darkroom.engineering/tempus/header.png)](https://github.com/darkroomengineering/tempus)

## 目的

Tempus 允许您合并您的全部 `requestAnimationFrame` (RAF)循环在一个循环中,以更好的性能,并给予你更好的控制他们的执行优先级.

## 安装

```bash
$ npm i @darkroom.engineering/tempus
```

## 使用量

```javascript
import Tempus from '@darkroom.engineering/tempus'

function onFrame(time, deltaTime) {
  // called every frame
}

// subscribe
const unsubscribe = Tempus.add(onFrame, 0)

// unsubscribe
unsubscribe()
// OR
Tempus.remove(onFrame)
```

## 方法

-   `add(callback, priority)`
-   `remove(callback)`

## 实例

### 列尼斯语Name

```js
Tempus.add((time) => {
  lenis.raf(time)
}, 0);
```

### 反应

```jsx
import { useFrame } from '@darkroom.engineering/hamo'

function Component() {
  useFrame((time, deltaTime) => {
    // called every frame
  })
}
```

### 目标

```js
gsap.ticker.remove(gsap.updateRoot);

Tempus.add((time) => {
  gsap.updateRoot(time / 1000);
}, 0);
```

## 常见问题

### @darkroom\.engineering/tempus 是什么？

一个RAF来统治他们注意：该包已被作者标记为弃用——The '@darkroom\.engineering/tempus' package has been renamed to 'tempus'\. Please update your dependencies: npm install tempus and visit the documentation: https://www\.npmjs\.com/package/tempus

### 如何安装 @darkroom\.engineering/tempus？

在项目目录运行 npm install @darkroom\.engineering/tempus，或使用 pnpm add / yarn add / bun add。

### @darkroom\.engineering/tempus 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @darkroom\.engineering/tempus 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @darkroom\.engineering/tempus 可以商用吗？

@darkroom\.engineering/tempus 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @darkroom\.engineering/tempus 的下载量有多少？

根据 npm 官方下载统计，@darkroom\.engineering/tempus 在 2026/10/12 – 2026/11/10 这 30 天内被下载 173,471 次，日均约 5,782 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @darkroom\.engineering/tempus 还在维护吗？

最新版本 0\.0\.46 发布于 2024/04/18（2 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/04/18。作者已将其标记为弃用，新项目建议寻找替代方案。