Merge pull request #16 from manudss/feature/#15-getinitialvalue

Author: NetanelBasal

.all-contributorsrc

@@ -49,6 +49,16 @@
         "code",
         "doc"
       ]
+    },
+    {
+      "login": "manudss",
+      "name": "Emmanuel De Saint Steban",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1046806?v=4",
+      "profile": "https://github.com/manudss",
+      "contributions": [
+        "code",
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 7

README.md

@@ -51,27 +51,23 @@ import { NgFormsManager } from '@ngneat/forms-manager';
 
 @Component({
   template: `
-   <form [formGroup]="onboardingForm">
-     <input formControlName="name">
-     <input formControlName="age">
-     <input formControlName="city">
-   </form>
-  `
+    <form [formGroup]="onboardingForm">
+      <input formControlName="name" />
+      <input formControlName="age" />
+      <input formControlName="city" />
+    </form>
+  `,
 })
 export class OnboardingComponent {
-
   onboardingForm: FormGroup;
 
-  constructor(
-    private formsManager: NgFormsManager,
-    private builder: FormBuilder
-  ) {}
+  constructor(private formsManager: NgFormsManager, private builder: FormBuilder) {}
 
   ngOnInit() {
     this.onboardingForm = this.builder.group({
       name: [null, Validators.required],
-      age:  [null, Validators.required],
-      city: [null, Validators.required]
+      age: [null, Validators.required],
+      city: [null, Validators.required],
     });
 
     this.formsManager.upsert('onboarding', this.onboardingForm);
@@ -353,6 +349,18 @@ export class SettingsComponent {
 }
 ```
 
+### `setInitialValue(name, value)` - Set the initial form's value
+
+```ts
+formsManager.setInitialValue('form', initialValue);
+```
+
+### `getInitialValue(name)` - Get the initial value or `undefined` if not exist.
+
+```ts
+formsManager.getInitialValue('form');
+```
+
 ## NgFormsManager Config
 
 You can override the default config by passing the `NG_FORMS_MANAGER_CONFIG` provider:
@@ -392,6 +400,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/Coly010"><img src="https://avatars2.githubusercontent.com/u/12140467?v=4" width="100px;" alt=""/><br /><sub><b>Colum Ferry</b></sub></a><br /><a href="https://github.com/ngneat/forms-manager/commits?author=Coly010" title="Code">💻</a> <a href="https://github.com/ngneat/forms-manager/commits?author=Coly010" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/mehmet-erim"><img src="https://avatars0.githubusercontent.com/u/34455572?v=4" width="100px;" alt=""/><br /><sub><b>Mehmet Erim</b></sub></a><br /><a href="https://github.com/ngneat/forms-manager/commits?author=mehmet-erim" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/dspeirs7"><img src="https://avatars2.githubusercontent.com/u/739058?v=4" width="100px;" alt=""/><br /><sub><b>David Speirs</b></sub></a><br /><a href="https://github.com/ngneat/forms-manager/commits?author=dspeirs7" title="Code">💻</a> <a href="https://github.com/ngneat/forms-manager/commits?author=dspeirs7" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/manudss"><img src="https://avatars3.githubusercontent.com/u/1046806?v=4" width="100px;" alt=""/><br /><sub><b>Emmanuel De Saint Steban</b></sub></a><br /><a href="https://github.com/ngneat/forms-manager/commits?author=manudss" title="Code">💻</a> <a href="https://github.com/ngneat/forms-manager/commits?author=manudss" title="Documentation">📖</a></td>
   </tr>
 </table>
 

projects/ngneat/forms-manager/src/lib/forms-manager.spec.ts

@@ -42,7 +42,7 @@ describe('FormsManager', () => {
     formsManager = null;
   });
 
-  fit('should update the store with forms value', fakeAsync(() => {
+  it('should update the store with forms value', fakeAsync(() => {
     expect(getSnapshot(formsManager)).toEqual({
       config: {
         value: '',
@@ -1184,4 +1184,60 @@ describe('FormsManager', () => {
     expect(spy).toHaveBeenCalledTimes(2);
     expect(spy).toHaveBeenCalledWith(['One', 'Two']);
   }));
+
+  describe('Initial Value', () => {
+    const fakeData = {
+      name: 'Chuck Norris',
+      email: '[email protected]',
+      date: '1940-03-10',
+      phone: {
+        number: '123456789007',
+        prefix: '+00',
+      },
+    };
+
+    const userForm = new FormGroup({
+      name: new FormControl('Chuck Norris'),
+      email: new FormControl('[email protected]'),
+      date: new FormControl('1940-03-10'),
+      phone: new FormGroup({
+        number: new FormControl('123456789007'),
+        prefix: new FormControl('+00'),
+      }),
+    });
+
+    it('should get and set initial Value for a control', () => {
+      formsManager.setInitialValue('config', 'initial');
+
+      expect(formsManager.getInitialValue('config')).toEqual('initial');
+    });
+
+    it('should get and set initial Value for a group of control', () => {
+      formsManager.setInitialValue('group', fakeData);
+
+      expect(formsManager.getInitialValue('group')).toEqual(fakeData);
+    });
+
+    it('should get initial Value for a group of control if withInitialValue option has been set in upsert', () => {
+      formsManager.upsert('user', userForm, { withInitialValue: true });
+
+      expect(formsManager.getInitialValue('user')).toEqual(fakeData);
+    });
+
+    it('should get initial Value for a group of control if withInitialValue option has been set in upsert', () => {
+      formsManager.upsert('user', userForm, { withInitialValue: true });
+
+      expect(formsManager.getInitialValue('user')).toEqual(fakeData);
+    });
+
+    it('should get undefined if withInitialValue option has been set in upsert', () => {
+      formsManager.upsert('user', userForm);
+
+      expect(formsManager.getInitialValue('user')).toBeUndefined();
+    });
+
+    it('should get undefined if no initial Value set', () => {
+      expect(formsManager.getInitialValue('other')).toBeUndefined();
+    });
+  });
 });

projects/ngneat/forms-manager/src/lib/forms-manager.ts

@@ -189,6 +189,23 @@ export class NgFormsManager<FormsState = any> {
     return null;
   }
 
+  /**
+   *
+   * Get the initial value for a control
+   *
+   * Will return undefined, if no initial value was returned.
+   *
+   * @example
+   *
+   * manager.getInitialValue('login');
+   *
+   */
+  getInitialValue<State = any>(name: keyof FormsState): State | undefined;
+  getInitialValue<T extends keyof FormsState>(name: keyof FormsState): FormsState[T] | undefined;
+  getInitialValue(name: keyof FormsState): any | undefined {
+    return this.initialValues$$.get(name);
+  }
+
   /**
    *
    * @example