Option max_record_size

The max_record_size option set a limit on the maximum number of characters to be contained in the field and line before an exception is raised.

• Type: number
• Optional
• Default: 0 (unlimited)
• Since: 4.0.0

A castable string will be converted to an integer and it is not activated by default. It is available since version version 4.0.0 and it was previously named "max_limit_on_data_read".

Use cases

This feature guards against a wrong delimiter or record_delimiter. It also prevent a CSV dataset from an uncontrolled source to fill the internal buffer memory.

Example

This example will throw an error with the message "Max Record Size: record exceed the maximum number of tolerated bytes of 10 on line 2" because the second record is longer than 10 characters.

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

parse(`
"first","last"
"Paul-Émile","Victor"
`.trim(), {
  max_record_size: 10
}, function(err){
  assert.ok(
    /Max Record Size/.test(err.message)
  );
});