Class AssetLoader

Creates a new AssetLoader instance with the specified configuration.

Example

// Default configuration
const loader = new AssetLoader();

// Custom configuration
const customLoader = new AssetLoader({
  maxConcurrentLoads: 5,
  timeout: 30000
});
Copy

Gets the current loading status including active and queued loads. Useful for monitoring loading progress and debugging.

Example

const status = loader.getLoadingStatus();
console.log(`Active: ${status.active}, Queued: ${status.queued}`);
Copy

Loads multiple promises organized as an object with named keys. The result preserves the same structure with resolved values.

Example

const assets = await loader.load({
  texture: loadTexture('path/to/texture.jpg'),
  model: loadModel('path/to/model.gltf'),
  audio: loadAudio('path/to/sound.mp3')
});

// Type-safe access to resolved values
console.log(assets.texture); // Texture
console.log(assets.model);   // Model
console.log(assets.audio);   // AudioBuffer
Copy

Loads multiple promises in bulk as an array. Supports both homogeneous arrays and heterogeneous tuples with type safety.

Example

// Homogeneous array
const textures = await loader.loadArray([
  loadTexture('texture1.jpg'),
  loadTexture('texture2.jpg'),
  loadTexture('texture3.jpg')
]);

// Heterogeneous tuple with type safety
const [texture, model, audio] = await loader.loadArray([
  loadTexture('texture.jpg'),
  loadModel('model.gltf'),
  loadAudio('sound.mp3')
] as const);
Copy

Loads a single promise with queue management, timeout, and concurrency control.

Example

const texture = await loader.loadSingle(loadTexture('texture.jpg'));
const model = await loader.loadSingle(loadModel('model.gltf'));
Copy

Loads multiple promises with retry capabilities organized as an object. Combines the structure of load() with the retry functionality of loadWithRetryArray().

Example

const assets = await loader.loadWithRetry({
  texture: [
    () => loadTexture('high-res.jpg'),
    () => loadTexture('low-res.jpg')
  ],
  model: [
    () => loadModel('detailed.gltf'),
    () => loadModel('simple.gltf')
  ]
});

console.log(assets.texture); // Texture (from successful factory)
console.log(assets.model);   // Model (from successful factory)
Copy

Loads multiple promises with retry capabilities for each one. Each promise has its own set of factory functions for retry attempts.

Example

const assets = await loader.loadWithRetryArray([
  [
    () => loadTexture('high-res.jpg'),
    () => loadTexture('low-res.jpg')
  ],
  [
    () => loadModel('detailed.gltf'),
    () => loadModel('simple.gltf')
  ]
]);
Copy

Loads a single promise with automatic retry using fallback factories. If the first promise fails, it will try the next factory in order.

Throws

When no promise factories are provided

Example

const texture = await loader.loadWithRetrySingle([
  () => loadTexture('high-quality.jpg'),    // Try first
  () => loadTexture('medium-quality.jpg'),  // Fallback 1
  () => loadTexture('low-quality.jpg')      // Fallback 2
]);
Copy

Waits until all currently active and queued loads are complete. Useful for ensuring all assets are loaded before proceeding.

Example

// Start multiple loads
loader.loadSingle(loadTexture('texture.jpg'));
loader.loadSingle(loadModel('model.gltf'));

// Wait for all to complete
await loader.waitForAllLoads();
console.log('All assets loaded!');
Copy