convert-csv-to-json 4.42.0 → 4.43.0

package/README.md

@@ -147,6 +147,7 @@ All APIs (Sync, Async and Browser) support the same configuration methods:
 - `supportQuotedField(bool)` - Handle quoted fields with embedded delimiters
 - `indexHeader(num)` - Specify header row (default: 0)
 - `trimHeaderFieldWhiteSpace(bool)` - Remove spaces from headers
+- `ignoreColumnIndexes(indexes)` - Exclude specific columns by index from the JSON output
 - `parseSubArray(delim, sep)` - Parse delimited arrays
 - `mapRows(fn)` - Transform, filter, or enrich each row
 - `getJsonFromStreamAsync(stream)` - Process CSV from Readable streams for NodeJS and Browser

package/docs/BROWSER.md

@@ -227,6 +227,22 @@ const json = convert.browser
 // Output: { Name: 'Alice', Age: '30' } (spaces removed from header)
 ```
 
+### Ignore Column Indexes
+
+```js
+const csv = 'name,age,active\nAlice,30,true\nBob,25,false';
+
+const json = convert.browser
+  .ignoreColumnIndexes([2])
+  .csvStringToJson(csv);
+
+// Output:
+// [
+//   { name: 'Alice', age: 30 },
+//   { name: 'Bob', age: 25 }
+// ]
+```
+
 ### Method Chaining
 
 ```js

package/docs/SYNC.md

@@ -198,6 +198,31 @@ const json = csvToJson.csvStringToJson(csv);
 const jsonString = csvToJson.csvStringToJsonStringified(csv);
 ```
 
+### Ignore Column Indexes
+Exclude specific columns from the JSON output by specifying their column indexes:
+
+```js
+// Ignore columns at index 2 and 3
+csvToJson
+  .ignoreColumnIndexes([2, 3])
+  .getJsonFromCsv('file.csv');
+```
+
+**Example Input:**
+```csv
+name,email,active,id
+John,john@example.com,true,0012
+Jane,jane@example.com,false,987
+```
+
+**Output:**
+```json
+[
+  { "name": "John", "email": "John,john@example.com" },
+  { "name": "Jane", "email": "jane@example.com" }
+]
+```
+
 ### Method Chaining
 
 Combine multiple configuration options:

package/index.d.ts

@@ -32,6 +32,12 @@ declare module 'convert-csv-to-json' {
      */
     parseSubArray(delimiter: string, separator: string): this;
 
+    /**
+     * Set column indexes to ignore
+     * Specified columns will be excluded from the JSON output
+     */
+    ignoreColumnIndexes(indexes: number[]): this;
+
     /**
      * Defines a custom encoding to decode a file
      */
@@ -139,6 +145,7 @@ declare module 'convert-csv-to-json' {
     fieldDelimiter(delimiter: string): this;
     indexHeader(index: number): this;
     parseSubArray(delimiter: string, separator: string): this;
+    ignoreColumnIndexes(indexes: number[]): this;
     mapRows(mapperFn: (row: any, index: number) => any | null): this;
 
     csvStringToJson(csvString: string): any[];

package/index.js

@@ -95,6 +95,26 @@ exports.parseSubArray = function (delimiter, separator) {
   return this;
 };
 
+/**
+ * Set column indexes to ignore
+ * Specified columns will be excluded from the JSON output
+ * @category 1-Core API
+ * @param {Array<number>} indexes - Array of column indexes to ignore
+ * @returns {object} Module context for method chaining
+ * @example
+ * csvToJson.ignoreColumnIndexes([1, 3]) // Ignore columns at index 1 and 3
+ */
+exports.ignoreColumnIndexes = function (indexes) {
+  if (!Array.isArray(indexes)) {
+    throw new TypeError('indexes must be an array of numbers');
+  }
+  if (!indexes.every(idx => Number.isInteger(idx) && idx >= 0)) {
+    throw new TypeError('All elements in indexes must be valid non-negative numbers (>= 0)');
+  }
+  csvToJson.ignoreColumnIndexes(indexes);
+  return this;
+};
+
 /**
  * Set custom file encoding for reading CSV files
  * Useful for non-UTF8 encoded files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convert-csv-to-json",
-  "version": "4.42.0",
+  "version": "4.43.0",
   "description": "Convert CSV to JSON",
   "main": "index.js",
   "types": "index.d.ts",

package/src/browserApi.js

@@ -71,6 +71,17 @@ class BrowserApi {
     return this;
   }
 
+  /**
+   * Configure columns to exclude from output
+   * @param {Array<number>} indexes - Column indexes to ignore
+   * @returns {this} For method chaining
+   * @private Used internally after validation in index.js
+   */
+  ignoreColumnIndexes(indexes) {
+    this.csvToJson.ignoreColumnIndexes(indexes);
+    return this;
+  }
+
   /**
    * Configure sub-array parsing for special field values
    * @param {string} delimiter - Bracket character (default: '*')

package/src/csvToJson.js

@@ -107,6 +107,17 @@ class CsvToJson {
     return this;
   }
 
+  /**
+   * Configure columns to exclude from output
+   * @param {Array<number>} indexes - Column indexes to ignore
+   * @returns {this} For method chaining
+   * @private Used internally after validation in index.js
+   */
+  ignoreColumnIndexes(indexes) {
+    this.indexesToIgnore = new Set(indexes);
+    return this;
+  }
+
   /**
    * Sets a mapper function to transform each row after conversion
    * @param {function(object, number): (object|null)} mapperFn - Function that receives (row, index) and returns transformed row or null to filter out
@@ -375,6 +386,10 @@ class CsvToJson {
   buildJsonResult(headers, currentLine) {
     let jsonObject = {};
     for (let j = 0; j < headers.length; j++) {
+      if (this.indexesToIgnore?.has(j)) {
+        continue;
+      }
+
       let propertyName = stringUtils.trimPropertyName(this.isTrimHeaderFieldWhiteSpace, headers[j]);
       let value = currentLine[j];
 

package/src/csvToJsonAsync.js

@@ -101,6 +101,17 @@ class CsvToJsonAsync {
         return this;
     }
 
+    /**
+     * Configure columns to exclude from output
+     * @param {Array<number>} indexes - Column indexes to ignore
+     * @returns {this} For method chaining
+     * @private Used internally after validation in index.js
+     */
+    ignoreColumnIndexes(indexes) {
+        this.csvToJson.ignoreColumnIndexes(indexes);
+        return this;
+    }
+
     /**
      * Read a CSV file and write parsed JSON to an output file (async)
      * @param {string} fileInputName - Path to input CSV file