NodeIO

I/O service for Node.js.

The most common use of the I/O service is to read/write a Document with a given path. Methods are also available for converting in-memory representations of raw glTF files, both binary (Uint8Array) and JSON (JSONDocument).

Usage:

import { NodeIO } from '@gltf-transform/core';

const io = new NodeIO();

// Read.
let document;
document = await io.read('model.glb'); // → Document
document = await io.readBinary(glb);   // Uint8Array → Document

// Write.
await io.write('model.glb', document);      // → void
const glb = await io.writeBinary(document); // Document → Uint8Array

By default, NodeIO can only read/write paths on disk. To enable HTTP requests, provide a Fetch API implementation (such as node-fetch) and enable setAllowHTTP. HTTP requests may optionally be configured with RequestInit parameters.

import fetch from 'node-fetch';

const io = new NodeIO(fetch, {headers: {...}}).setAllowHTTP(true);

const document = await io.read('https://example.com/path/to/model.glb');