@voxel-3d/docs
    Preparing search index...

    Class FileSystemAccess

    File System Access API 래퍼

    Implements

    Index

    Accessors

    hasDirectory directoryName

    Constructors

    constructor

    Methods

    pickDirectory getFile getFileHandle createBlobUrl createBlobUrlWithSize listFiles listJsonFiles listModelFiles revokeAllBlobUrls dispose

    Accessors

    • get hasDirectory(): boolean

      폴더가 선택되었는지 여부

      Returns boolean

    • get directoryName(): string | null

      선택된 폴더 이름

      Returns string | null

    Constructors

    Methods

    • 폴더 선택 다이얼로그 표시

      Returns Promise<boolean>

      성공 여부

    • 상대 경로로 파일 가져오기

      Parameters

      • relativePath: string

        상대 경로

      Returns Promise<File | null>

      File 객체 또는 null

    • Returns the file handle for a relative path without reading its bytes. 상대 경로의 파일 핸들을 바이트 읽기 없이 반환합니다.

      Parameters

      • relativePath: string

        Relative path within the selected directory 선택된 디렉토리 내 상대 경로

      Returns FileSystemFileHandle | null

      The matching file handle, or null when the path is unknown 일치하는 파일 핸들, 경로를 찾을 수 없으면 null

      워커 로딩 PoC v2 경로 전용입니다. 메인 스레드에서 .bin/이미지 바이트를 읽어 워커로 structured-clone 복사(대용량 복사 → OOM)하는 대신, 파일 핸들만 워커로 postMessage하여 워커가 handle.getFile()→arrayBuffer()로 바이트를 직접 읽게 합니다. 바이트가 워커에서 태어나므로 메인→워커 복사가 0입니다. 핸들은 이미 _fileMap에 상주하므로 이 조회는 동기적이며 I/O가 없습니다. 경로 해석은 getFile과 동일한 정규화/대체 경로 규칙을 재사용합니다. Worker-loading PoC v2 path. Instead of the main thread reading .bin/image bytes and structured-clone-copying them into the worker (large copy → OOM), only the file handle is posted to the worker, which reads the bytes itself via handle.getFile()→arrayBuffer() (bytes born in the worker, zero copy). The handle already resides in _fileMap, so this lookup is synchronous with no I/O. Path resolution reuses the same normalization/alternative-path rules as getFile.

    • 상대 경로로 Blob URL 생성

      Parameters

      • relativePath: string

        상대 경로

      Returns Promise<string | null>

      Blob URL 또는 null

    • Creates a Blob URL and returns the file size in a single file handle read. 단일 파일 핸들 조회로 Blob URL과 파일 크기를 함께 반환합니다.

      Parameters

      • relativePath: string

        Relative path within the selected directory 선택된 디렉토리 내 상대 경로

      Returns Promise<{ url: string; size: number } | null>

      Blob URL and byte size, or null if the file is unavailable Blob URL과 바이트 크기, 파일을 찾을 수 없으면 null

      createBlobUrl + 별도 getFile 크기 조회는 파일당 핸들 읽기를 2회 유발해 대량 로드 준비 구간을 지연시킵니다. 리포트용 크기 집계 시 이 메서드로 조회를 1회로 합칩니다. Reading size via a separate getFile after createBlobUrl doubles the file handle reads per file, slowing bulk-load preparation. This merges them.

    • 특정 확장자의 파일 목록 조회

      Parameters

      • Optionalextensions: string[]

        확장자 목록 (e.g., ['.json', '.gltf'])

      Returns FileInfo[]

      파일 정보 배열

    • 리소스 정리

      Returns void

    Settings

    Member Visibility

    On This Page

    Accessors
    Constructors
    Methods