createDataSource 🚧

This function creates a DataSource for an (i.e. parses the entire data set in one operation). It can be called on "already loaded" data such as ArrayBuffer and string objects.

In contrast to load and parse which parse a single file, the returned DataSource is a a class instance that offers an API for querying additional data (such as tiles from a tile server).

Usage

The return value from fetch or fetchFile is a Promise that resolves to the fetch Response object and can be passed directly to the non-sync parser functions:

import {createDataSource, parse} from '@loaders.gl/core';
import {OBJLoader} from '@loaders.gl/obj';

const source = await createDataSource(url, OBJLoader);
// Application code here
...

Selection is supported.

import {fetchFile, parseInBatches} from '@loaders.gl/core';
import {CSVLoader} from '@loaders.gl/obj';

const batchIterator = await createDataSource(url, CSVLoader);
for await (const batch of batchIterator) {
  console.log(batch.length);
}

Handling errors

try {
  const response = await fetch(url); // fetch can throw in case of network errors
  const data = await parse(response); // parse will throw if server reports an error
} catch (error) {
  console.log(error);
}

Functions