hmrHandler.ts — vite Source File

Architecture documentation for hmrHandler.ts, a typescript file in the vite codebase. 1 imports, 2 dependents.

File typescript HMRClient HotRuntime 1 imports 2 dependents 1 functions 1 classes

Entity Profile

HMRClient→ HotRuntime→ hmrHandler.ts — vite Source File

Dependency Diagram

graph LR
  028d7bbe_154e_0f3f_836a_0c92f8021168["hmrHandler.ts"]
  ccb8a028_b1ec_3743_cfbe_0ac5315bc7c3["hmrPayload"]
  028d7bbe_154e_0f3f_836a_0c92f8021168 --> ccb8a028_b1ec_3743_cfbe_0ac5315bc7c3
  85908ff5_4d12_826d_8235_531f91538758["client.ts"]
  85908ff5_4d12_826d_8235_531f91538758 --> 028d7bbe_154e_0f3f_836a_0c92f8021168
  569b12a9_015e_564e_efd3_205cedee54dd["hmrHandler.ts"]
  569b12a9_015e_564e_efd3_205cedee54dd --> 028d7bbe_154e_0f3f_836a_0c92f8021168
  style 028d7bbe_154e_0f3f_836a_0c92f8021168 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

import type { HotPayload } from '#types/hmrPayload'

// updates to HMR should go one after another. It is possible to trigger another update during the invalidation for example.
export function createHMRHandler(
  handler: (payload: HotPayload) => Promise<void>,
): (payload: HotPayload) => Promise<void> {
  const queue = new Queue()
  return (payload) => queue.enqueue(() => handler(payload))
}

class Queue {
  private queue: {
    promise: () => Promise<void>
    resolve: (value?: unknown) => void
    reject: (err?: unknown) => void
  }[] = []
  private pending = false

  enqueue(promise: () => Promise<void>): Promise<void> {
    return new Promise<any>((resolve, reject) => {
      this.queue.push({
        promise,
        resolve,
        reject,
      })
      this.dequeue()
    })
  }

  dequeue(): boolean {
    if (this.pending) {
      return false
    }
    const item = this.queue.shift()
    if (!item) {
      return false
    }
    this.pending = true
    item
      .promise()
      .then(item.resolve)
      .catch(item.reject)
      .finally(() => {
        this.pending = false
        this.dequeue()
      })
    return true
  }
}