docs(babel_config): add js modification example

Author: Murat

src/__tests__/unit/utils/jsObjectParser.spec.ts

@@ -103,6 +103,25 @@ describe('jsObjectParser', () => {
       "
     `);
   });
+  it('should merge append', async () => {
+    const content = 'module.exports = { ok: 1 };';
+    const parser = new JsObjectParser();
+    parser.parse(content);
+    parser.merge(
+      {
+        'module.exports': {
+          ok: 2,
+          newObj: 2,
+        },
+      },
+      { strategy: 'append' }
+    );
+    expect(await prettier.format(parser.stringify(), prettierConfig))
+      .toMatchInlineSnapshot(`
+      "module.exports = { ok: 1, newObj: 2 };
+      "
+    `);
+  });
   it('should support partial', async () => {
     const content = "module.exports = { obj2: {t1: {t2: ''}, t3: 1 }};";
     const parser = new JsObjectParser();

src/utils/jsObjectParser.ts

@@ -498,7 +498,16 @@ export class JsObjectParser {
             opts.strategy === 'merge_distinct')
         ) {
           this._merge(value, exprObject.tree, opts);
-        } else {
+        } else if (!forceAssign && opts.strategy === 'append') {
+          const existingExpr = tree.find(expr => {
+            return (
+              (expr.type === 'variable' || expr.type === 'property') &&
+              expr.name.replace(/['"[\]]/g, '') === key
+            );
+          }) as VariableExpression | PropertyExpression | undefined;
+
+          if (!existingExpr) this._merge(value, exprObject.tree, opts);
+        } else if (opts.strategy === 'assign') {
           const newExpr = this._objectToExpr(value);
           exprObject.valueType = newExpr.valueType;
           exprObject.tree = newExpr.tree;

website/docs/guides/task-types/android-tasks/android-manifest.md

@@ -46,7 +46,7 @@ AndroidManifest.xml modifications, including adding, updating, or deleting attri
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/build-gradle.md

@@ -47,7 +47,7 @@ changes to different sections of the `build.gradle` file.
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/gradle-properties.md

@@ -13,7 +13,7 @@ The `gradle_properties` task allows you to customize gradle.properties file, whi
 
 | Property | Type                                            | Description                                                                                                                                              |
 |:---------|:------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
-| task     | "gradle_properties", required                           | Specifies the task type, which should be set to "gradle_properties" for this task.                                                                               |
+| task     | "gradle_properties", required                   | Specifies the task type, which should be set to "gradle_properties" for this task.                                                                       |
 | name     | string                                          | An optional name for the task. If provided, the task state will be saved as a variable. Visit [Task and Action States](../../states) page to learn more. |
 | label    | string                                          | An optional label or description for the task.                                                                                                           |
 | when     | object                                          | Visit [Conditional Tasks and Actions](../../when) page to learn how to execute task conditionally.                                                       |
@@ -43,7 +43,7 @@ The `gradle_properties` task allows you to customize gradle.properties file, whi
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/main-activity.md

@@ -45,7 +45,7 @@ file of the android application. This task provides the flexibility to make chan
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/main-application.md

@@ -46,7 +46,7 @@ kotlin file.
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/settings-gradle.md

@@ -44,7 +44,7 @@ the android application. This task provides the flexibility to make changes to d
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/android-tasks/strings-xml.md

@@ -43,7 +43,7 @@ The `strings_xml` task allows you to modify the strings.xml file in an Android p
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties
 

website/docs/guides/task-types/ios-tasks/app_delegate.md

@@ -48,7 +48,7 @@ task is particularly useful for integrating third-party libraries or SDKs that r
 | prepend  | string or `{file: string}` | Text or code to prepend at the beginning of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to prepend. |
 | append   | string or `{file: string}` | Text or code to append at the end of the specified context. It can be a string or an object with a `file` field that points to a file containing the code to append.         |
 | replace  | string or `{file: string}` | Text or code to replace the entire specified context. It can be a string or an object with a `file` field that points to a file containing the code to replace.              |
-| script   | string or `{file: string}` | JS code script to evaluate. It can be a string or an object with a `file` field that points to a file containing the script. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content) |
+| script   | string                     | JS code script to evaluate. In script these functions are available to be called: `await prepend(content), await append(content), await replace(content)                     |
 
 ### Other properties