在线体验

交互式体验 UntilJS！尝试不同的方法，看看它们是如何工作的。

PlaygroundtoBe() - Wait until equals a value

MethodtoBe() toMatch() toBeTruthy() toBeNull() toBeUndefined() toBeNaN() changed() changedTimes() toContains()

Target Value

Timeout (ms)

Generated Code

import until from 'untiljs'

let value = 0
setTimeout(() => {
  value = 5
}, 1000)

await until(() => value).toBe(5)
console.log('Condition met!')

Tips

• Use toMatch() for custom conditions like v > 3 or v.includes('text')
• Use not.* to invert any condition, e.g., not.toBe(5)
• Add { timeout: 3000, throwOnTimeout: true } to throw on timeout
• Use { deep: true } for deep object comparison

快速示例

基础用法

import until from 'untiljs'

// 等待某个值
let count = 0
setTimeout(() => count = 5, 1000)
await until(() => count).toBe(5)

// 等待自定义条件
await until(() => count).toMatch(v => v > 3)

// 等待真值
let data = null
setTimeout(() => data = { name: 'John' }, 500)
await until(() => data).toBeTruthy()

带超时

// 超时不抛出错误
const result = await until(() => value).toBe(5, { timeout: 3000 })

// 超时抛出错误
try {
  await until(() => value).toBe(5, { timeout: 3000, throwOnTimeout: true })
} catch (e) {
  console.log('超时了！')
}

深度比较

let config = { server: { port: 3000 } }
setTimeout(() => {
  config = { server: { port: 8080 } }
}, 500)

await until(() => config).toBe(
  { server: { port: 8080 } },
  { deep: true }
)

Not 修饰符

// 等待不再是 null
let data = null
setTimeout(() => data = 'loaded', 500)
await until(() => data).not.toBeNull()

// 等待不再等于某值
let value = 5
setTimeout(() => value = 10, 500)
await until(() => value).not.toBe(5)