1.9.0 • Public • Published

code style: prettier codecov semantic-release


This module allows you to replace a specific property in a JSON.

Table of Contents generated with DocToc

Comand line usage

You can use this via the following command:

replace-json-property pathToFile property value

This command replaces all occurences of the matching property. It also replaces occurences in nested objects or objects in arrays.

The following command would replace all values of the foo property with 'test' inside the test.json.

replace-json-property ./test.json foo test,

Executing the command above on the given JSON

    "foo": "bar",
    "a": {
        "b": 1,
        "foo": "bar",
        "c": [
            {"d": 1, "foo": "bar"},
            {"d": 2, "foo": "bar"},
            {"d": 3, "foo": "bar"},

results in:

    "foo": "test",
   	"a": {
        "b": 1,
        "foo": "test",
        "c": [
            {"d": 1, "foo": "test"},
            {"d": 2, "foo": "test"},
            {"d": 3, "foo": "test"},

Short form

All commands explained above can also be run with the shortcut version rjp.

rjp ./test.json foo test,

Usage from code

You can also use the replace function in your JavaScript code.

  1. Using module imports

    import {replace} from 'replace-json-property';
    replace('./environment/test.json', 'foo', 'new value');
  2. Using commonjs

    const replaceJSONProperty = require('replace-json-property');
    replaceJSONProperty.replace('./environment/test.json', 'foo', 'new value');


The following flags allow you to configure how the resulting file is written.

Option Description Default
-s or --spaces Add the spaces the file should be written with, for example (2, 4) 2
-e or --eol Add the line ending the file should be written with, for example "\r\n" "\n"
--silent Silent mode. Executes without log messages False
--limit Limit the number of replacements 0 (unlimited)
--add When set to true propertys that do not exist will be added false

Help command

You can always run the help command to see how the signature looks

replace-json-property -h


replace-json-property --help

To get the current version use the --version or -v command.

Package Sidebar


npm i replace-json-property

Weekly Downloads






Unpacked Size

85.9 kB

Total Files


Last publish


  • kreuzerk