Skip to main content
Parse a text string (CSV or TSV) into the Data structure expected by @graphysdk/core.

fromText

import { fromText } from '@graphysdk/data-import-utils/text';

const data = fromText(csvContent, 'csv');
const data = fromText(tsvContent, 'tsv', { hasHeader: false });

Signature

function fromText(
  input: string,
  format: 'csv' | 'tsv',
  options?: DelimitedParseOptions
): Data

Options

format
TextFileFormat
required
The text format: 'csv' or 'tsv'.
options.hasHeader
boolean
default:"true"
Whether the first row contains column headers. When false, columns are auto-named Column 1, Column 2, etc.
options.locale
VizLocale
default:"EN_US"
Locale for number parsing. Determines thousand/decimal separator conventions.
options.maxFileSize
number
default:"5"
Maximum allowed input size in megabytes.

Examples

Parse CSV from memory

import { fromText } from '@graphysdk/data-import-utils/text';

const csv = 'Name,Revenue\nAcme,1000\nGlobex,2000';
const data = fromText(csv, 'csv');

Handle a browser text file upload

import { fromText } from '@graphysdk/data-import-utils/text';

const file: File = input.files[0];
const text = await file.text();
const data = fromText(text, 'csv');