while using header option with XLSX.utils.json_to_sheet , headers not overriding

While I try to change header titles by passing array of titles to options like below it does not override the headers. Instead it writes new headers first and original data with old headers again from next cell.

Here is my code

const ws: XLSX.WorkSheet = XLSX.utils.json_to_sheet(json, {header: headerColumns});
    const wb: XLSX.WorkBook = XLSX.utils.book_new();
    XLSX.utils.book_append_sheet(wb, ws, 'Transactions');
    const excelBuffer: any = XLSX.write(wb, { bookType: 'xlsx', type: 'array' });
    this.saveAsExcelFile(excelBuffer, excelFileName);

Also see attached exported file. sample.xlsx

why is it happening? I just want to rename the headers , everything else is working file.

[SheetJSDev]

@paustint that’s an unrelated issue and should be tracked separately.

@SandeshSarfare @dottodot This is intended behavior. If you want to overwrite the values in the header cells, use aoa_to_sheet and directly modify the header names.

As described in the docs, header option is “Use specified column order (default Object.keys)”.

This option exists because of a fundamental ambiguity. Suppose you were trying to write the following to a worksheet:

[
  {Price: 1, Name: "a"},
  {Name: "b", Price: 2},
]

In what order should fields be written? If you applied the naive approach of using Object.keys order, you’d get a table like

1  |  a
b  |  2

That probably doesn’t make sense. So header lets you control the order of the output columns. Each value in the header array is a key that is checked against each object. So if you pass the header ["Price", "Name"] you will see

1  |  a
2  |  b

But if you pass ["Name", "Price"] you will see

a  |  1
b  |  2

When a key is present in an object but missing from the header array, it is added to the end

[dottodot]

I’m having the same issue as above.