Class HandleCache<T, H>

A sparse, per-collection cache keyed by wasm handle. HandleCache.wrap lazily builds a wrapper the first time a handle is seen and returns that same instance ever after, so lookups are an array index (not a map hash) and identity is preserved. A null handle maps to null, which the type system then forces the caller to check.

Type Parameters

T extends Handle<H>
H = EngineModule

Index

Constructors

Methods

wrap get evict clear

Constructors

constructor

new HandleCache<T extends Handle<H>, H = EngineModule>(
host: H,
make: HandleFactory<T, H>,
): HandleCache<T, H>
Type Parameters
- T extends Handle<H>
- H = EngineModule
Parameters
- host: H
- make: HandleFactory<T, H>
Returns HandleCache<T, H>
- Defined in src/core/handle.ts:102

Methods

wrap

wrap(index: number): T | null
Wrap a handle, reusing the existing wrapper; returns null for the null handle.
Parameters
- index: number
Returns T | null
- Defined in src/core/handle.ts:108

get

get(index: number): T | null
Return the cached wrapper for a handle without creating one.
Parameters
- index: number
Returns T | null
- Defined in src/core/handle.ts:114

evict

evict(index: number): void
Invalidate and drop the wrapper for a handle, so a later reuse of the handle is clean.
Parameters
- index: number
Returns void
- Defined in src/core/handle.ts:119

clear

clear(): void
Invalidate and drop every cached wrapper (e.g. when the document is replaced).

Returns void
- Defined in src/core/handle.ts:128