Loading Errors: Diagnosis & Recovery

Overview

This skill covers every failure mode that occurs when loading IFC files or initializing the ThatOpen fragment pipeline. Each error pattern maps to a specific root cause and a concrete fix.

Use this skill when:

• An IFC file fails to load or parse
• WASM initialization throws errors
• The viewer shows nothing after loading
• Fragment worker errors appear in the console
• Elements are missing from the loaded model

Critical Warnings

1. ALWAYS call await ifcLoader.setup() before ifcLoader.load() — skipping setup causes silent null reference failures.
2. ALWAYS call fragmentsManager.init(workerURL) before any fragment operation — the worker is required for all data operations.