Option `delimiter`

The delimiter option set the delimiter between the fields of a record. It can be one or multiple characters. The default value is a comma ,.

Type: string|Buffer
Optional
Default: "," (a one character comma)
Since: 0.0.1
Related: record_delimiter, quote, escape — see Available Options

Default behavior

By default the generated CSV data set has fields separated by commas ,:

import { stringify } from 'csv-stringify';
import assert from 'node:assert';

stringify([
  ['1', '2'],
  ['3', '4']
], function(err, records){
  assert.equal(records, '1,2\n3,4\n');
});

./packages/csv-stringify/samples/option.delimiter_single.js

Custom behaviour

One or multiple characters can be defined to customise the field delimiter:

import { stringify } from 'csv-stringify';
import assert from 'node:assert';

stringify([
  ['1', '2'],
  ['3', '4']
], {
  delimiter: ':)'
}, function(err, records){
  assert.equal(records, '1:)2\n3:)4\n');
});

./packages/csv-stringify/samples/option.delimiter_single.js

Option delimiter

Default behavior

Custom behaviour

Option `delimiter`