Interface ParseBinaryOptions<Header>

Parse options for CSV binary.

interface ParseBinaryOptions<Header> {
    charset?: string;
    decomposition?: CompressionFormat;
    delimiter?: string;
    fatal?: boolean;
    header?: Header;
    ignoreBOM?: boolean;
    quotation?: string;
}

Type Parameters

  • Header extends ReadonlyArray<string>

Hierarchy (view full)

Properties

charset?: string

You can specify the character encoding of the binary.

Remarks

TextDecoderStream is used internally.

See Encoding API Compatibility for the encoding formats that can be specified.

Default

'utf-8'
decomposition?: CompressionFormat

If the binary is compressed by a compression algorithm, the decompressed CSV can be parsed by specifying the algorithm.

Remarks

Make sure the runtime you are running supports stream decompression.

See DecompressionStream Compatibility.

delimiter?: string

CSV field delimiter. If you want to parse TSV, specify '\t'.

Remarks

Detail restrictions are as follows:

  • Must not be empty
  • Must be a single character
    • Multi-byte characters are not supported
  • Must not include CR or LF
  • Must not be the same as the quotation

Default

','
fatal?: boolean

If the binary has a invalid character, you can specify whether to throw an error.

Remarks

If the property is true then a decoder will throw a TypeError if it encounters malformed data while decoding.

If false the decoder will substitute the invalid data with the replacement character U+FFFD (�).

See TextDecoderOptions.fatal for more information.

Default

false
header?: Header

CSV header.

Remarks

If you specify this option, the first record will be treated as a normal record.

If you don't specify this option, the first record will be treated as a header.

Default

undefined
ignoreBOM?: boolean

If the binary has a BOM, you can specify whether to ignore it.

Remarks

If you specify true, the BOM will be ignored. If you specify false or not specify it, the BOM will be treated as a normal character. See TextDecoderOptions.ignoreBOM for more information about the BOM.

Default

false
quotation?: string

CSV field quotation.

Default

'"'