Just Timers

Just Timers 是一款 iOS 计时器应用。Protocol Launcher 允许您生成官方 URL scheme 链接，用于创建、删除、暂停、重置、重新开始和继续计时器。

使用方式

有两种使用此库的方式：

• 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
• 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。

生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

说明

Just Timers 官方文档将单个计时器的格式写为 justtimers://x-callback-url/[action]/?[parameter]=[value]，将控制所有计时器的格式写为 justtimers://x-callback-url/[action]/all。官方页面没有记录 x-success 或 x-error 这类回调查询参数，因此此模块不暴露这些参数。

创建计时器必须传入 name，并在 duration 和 seconds 中二选一。新计时器默认立即运行；传入 active: false 可以创建为暂停状态。

使用 Duration 创建计时器

On-Demand

import { createTimer } from 'protocol-launcher/just-timers'

const url = createTimer({
  name: 'Tea',
  duration: '2 minutes',
})

使用秒数创建暂停的计时器

On-Demand

import { createTimer } from 'protocol-launcher/just-timers'

const url = createTimer({
  name: 'Tea',
  seconds: 120,
  active: false,
})

删除计时器

On-Demand

import { deleteTimer } from 'protocol-launcher/just-timers'

const url = deleteTimer({
  name: 'Tea',
})

暂停所有计时器

On-Demand

import { pauseTimer } from 'protocol-launcher/just-timers'

const url = pauseTimer({
  all: true,
})

重置计时器

On-Demand

import { resetTimer } from 'protocol-launcher/just-timers'

const url = resetTimer({
  name: 'Tea',
})

重新开始计时器

On-Demand

import { restartTimer } from 'protocol-launcher/just-timers'

const url = restartTimer({
  name: 'Tea',
})

继续计时器

On-Demand

import { resumeTimer } from 'protocol-launcher/just-timers'

const url = resumeTimer({
  name: 'Tea',
})

生成的 URL

createTimer({ name: 'Tea', duration: '2 minutes' })
// => 'justtimers://x-callback-url/new/?name=Tea&duration=2%20minutes'

createTimer({ name: 'Tea', seconds: 120, active: false })
// => 'justtimers://x-callback-url/new/?name=Tea&seconds=120&active=false'

deleteTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/delete/?name=Tea'

deleteTimer({ all: true })
// => 'justtimers://x-callback-url/delete/all'

pauseTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/pause/?name=Tea'

pauseTimer({ all: true })
// => 'justtimers://x-callback-url/pause/all'

resetTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/reset/?name=Tea'

resetTimer({ all: true })
// => 'justtimers://x-callback-url/reset/all'

restartTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/restart/?name=Tea'

restartTimer({ all: true })
// => 'justtimers://x-callback-url/restart/all'

resumeTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/resume/?name=Tea'

resumeTimer({ all: true })
// => 'justtimers://x-callback-url/resume/all'

官方文档

• Just Timers Shortcuts API