API 参考
Hyper Scheduler 的完整 API 文档。
核心 API
Scheduler
核心调度器类,负责任务的注册、调度和生命周期管理。
主要方法:
createTask()- 注册新任务start()/stop()- 启动/停止调度器startTask()/stopTask()- 启动/停止指定任务triggerTask()- 手动触发任务getTask()/getAllTasks()- 查询任务deleteTask()- 删除任务on()- 订阅事件
Task
任务配置和运行时状态。
核心接口:
TaskDefinition- 任务定义TaskOptions- 任务选项Task- 任务运行时对象
配置选项:
- 调度规则(Cron / 时间间隔)
- 重试策略
- 时区设置
- 错误处理
DevTools
浏览器环境下的可视化调试工具。
功能特性:
- 任务列表和状态监控
- 时间线视图
- 执行历史
- 实时日志
配置选项:
- 主题模式
- 停靠位置
- 界面语言
- 悬浮按钮自定义
类型定义
完整的 TypeScript 类型定义。
核心类型:
SchedulerConfigTaskDefinitionTaskOptionsTaskTaskStatusExecutionRecord
插件类型:
HyperSchedulerPluginDevToolsOptions
快速查找
按功能分类
任务管理
- 创建任务 -
scheduler.createTask() - 删除任务 -
scheduler.deleteTask() - 查询任务 -
scheduler.getTask() - 获取所有任务 -
scheduler.getAllTasks()
任务控制
- 启动调度器 -
scheduler.start() - 停止调度器 -
scheduler.stop() - 启动任务 -
scheduler.startTask() - 停止任务 -
scheduler.stopTask() - 手动触发 -
scheduler.triggerTask()
任务配置
事件监听
调试工具
- DevTools 配置 - 初始化选项
- 主题设置 - light / dark / auto
- 语言设置 - en / zh
使用示例
基础用法
typescript
import { Scheduler } from 'hyper-scheduler';
const scheduler = new Scheduler({ debug: true });
scheduler.createTask({
id: 'my-task',
schedule: '*/5 * * * * *',
handler: () => console.log('Task executed')
});
scheduler.start();带重试和错误处理
typescript
scheduler.createTask({
id: 'api-sync',
schedule: '5m',
handler: async () => {
await syncWithAPI();
},
options: {
retry: {
maxAttempts: 3,
initialDelay: 1000,
factor: 2
},
onError: (error, taskId) => {
console.error(`Task ${taskId} failed:`, error);
}
}
});使用 DevTools
typescript
import { Scheduler, DevTools } from 'hyper-scheduler';
const scheduler = new Scheduler({
plugins: [
new DevTools({
theme: 'dark',
language: 'zh'
})
]
});