A package to add additional properties to every object in a JSON array and return a new JSON file or string.

This started out as a single script and I saw the potential to flesh it out and break it apart to use as my first NPM package.

There are zero dependencies here, it is just a series of JS files that take in your original data, alongside an object containing the desired keys and values you want to add to each object in your initial array.

There are examples of the JSON data that the function expects under the /src/lib/mocks dir.

const [modifyJsonAndReturnJson, modifyJsonAndReturnFile] = modifyJsonArray();
const newJsonArray = modifyJsonAndReturnJson(input, additions, options);

modifyJsonAndReturnFile(input, additions, options);

input

This defines the resource of which you wish to modify. This can either be

• A string path to a JSON file
• An Array of objects

additions

An object containing the keys and values what you wish added to each object.

options (optional)

An object containing the following options:

random (optional)

A Boolean flag that lets you decide if you want to randomise what value is added to each object per property. Default is set to false.

filename (optional)

The name of the file you'd like to create.

fileSaveLocation (optional)

If you wish to create a file, where would you want the file to be created. Default is ./.

The return value is dependent on which function you invoke.

• modifyJsonAndReturnJson - String of json data.
• modifyJsonAndReturnFile - void. A new file will be created.

This package is only built for use with ESM compatiable projects. Therefore use ESM syntax:

import modifyJsonArray from "json-array-modifier";
import input from "./mocks/mockInput.json" assert { type: "json" };
import additions from "./mocks/mockAdditions.json" assert { type: "json" };

const [modifyJsonAndReturnJson] = modifyJsonArray();

const options = {
  random: true,
  fileName: "newJsonData",
  fileSaveLocation: "../../tmp",
};

const newJSON = modifyJsonAndReturnJson(input, additions, options);

console.log(newJSON);