clash-verge-rev/clash-verge-rev · error · Error

timed out waiting for graceful dev shutdown

Error message

timed out waiting for graceful dev shutdown

What it means

Error "timed out waiting for graceful dev shutdown" thrown in clash-verge-rev/clash-verge-rev.

Source

Thrown at scripts/dev-control.mjs:231

  waitForPortClosed: waitForClosed,
  waitForChildExit,
  terminateGroup,
  finalizeGroup = terminateGroup,
  exit,
  report = (message) => console.error(message),
  timeoutMs = DEFAULT_TIMEOUT_MS,
  forceTimeoutMs = 2_000,
  now = Date.now,
}) {
  let signalCount = 0
  let forced = false
  let forcedPromise
  let groupFinalizationPromise

  const remainingBudget = (deadline) => {
    const remaining = deadline - now()
    if (remaining <= 0) {
      throw new Error('timed out waiting for graceful dev shutdown')
    }
    return remaining
  }

  const finalizeOnce = (operation, budget) => {
    groupFinalizationPromise ??= Promise.resolve().then(() => operation(budget))
    return groupFinalizationPromise
  }

  const gracefulShutdown = async () => {
    const deadline = now() + timeoutMs
    try {
      const record = await requestQuit(remainingBudget(deadline))
      if (forced) return false
      await waitForClosed(record.port, remainingBudget(deadline))
      if (forced) return false
      await waitForChildExit(remainingBudget(deadline))
      if (forced) return false

View on GitHub (pinned to 5cad0f2799)

When it happens

Trigger: Thrown at scripts/dev-control.mjs:231 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

AI-assisted analysis of clash-verge-rev/clash-verge-rev@5cad0f2799 (2026-08-12). Data as JSON: /api/errors/c00ef47c4d519c2b. Report an issue: GitHub.