angular-docs-cn/packages/forms/test/form_builder_spec.ts

/**
 * @license
 * Copyright Google Inc. All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.io/license
 */
import {fakeAsync, tick} from '@angular/core/testing';
import {beforeEach, describe, expect, it} from '@angular/core/testing/src/testing_internal';
import {FormBuilder, Validators} from '@angular/forms';
import {of } from 'rxjs';

(function() {
  function syncValidator(_: any /** TODO #9100 */): any /** TODO #9100 */ { return null; }
  function asyncValidator(_: any /** TODO #9100 */) { return Promise.resolve(null); }

  describe('Form Builder', () => {
    let b: FormBuilder;

    beforeEach(() => { b = new FormBuilder(); });

    it('should create controls from a value', () => {
      const g = b.group({'login': 'some value'});

      expect(g.controls['login'].value).toEqual('some value');
    });

    it('should create controls from a boxed value', () => {
      const g = b.group({'login': {value: 'some value', disabled: true}});

      expect(g.controls['login'].value).toEqual('some value');
      expect(g.controls['login'].disabled).toEqual(true);
    });

    it('should create controls from an array', () => {
      const g = b.group(
          {'login': ['some value'], 'password': ['some value', syncValidator, asyncValidator]});

      expect(g.controls['login'].value).toEqual('some value');
      expect(g.controls['password'].value).toEqual('some value');
      expect(g.controls['password'].validator).toEqual(syncValidator);
      expect(g.controls['password'].asyncValidator).toEqual(asyncValidator);
    });

    it('should use controls whose form state is a primitive value', () => {
      const g = b.group({'login': b.control('some value', syncValidator, asyncValidator)});

      expect(g.controls['login'].value).toEqual('some value');
      expect(g.controls['login'].validator).toBe(syncValidator);
      expect(g.controls['login'].asyncValidator).toBe(asyncValidator);
    });

    it('should support controls with no validators and whose form state is null', () => {
      const g = b.group({'login': b.control(null)});
      expect(g.controls['login'].value).toBeNull();
      expect(g.controls['login'].validator).toBeNull();
      expect(g.controls['login'].asyncValidator).toBeNull();
    });

    it('should support controls with validators and whose form state is null', () => {
      const g = b.group({'login': b.control(null, syncValidator, asyncValidator)});
      expect(g.controls['login'].value).toBeNull();
      expect(g.controls['login'].validator).toBe(syncValidator);
      expect(g.controls['login'].asyncValidator).toBe(asyncValidator);
    });

    it('should support controls with no validators and whose form state is undefined', () => {
      const g = b.group({'login': b.control(undefined)});
      expect(g.controls['login'].value).toBeNull();
      expect(g.controls['login'].validator).toBeNull();
      expect(g.controls['login'].asyncValidator).toBeNull();
    });

    it('should support controls with validators and whose form state is undefined', () => {
      const g = b.group({'login': b.control(undefined, syncValidator, asyncValidator)});
      expect(g.controls['login'].value).toBeNull();
      expect(g.controls['login'].validator).toBe(syncValidator);
      expect(g.controls['login'].asyncValidator).toBe(asyncValidator);
    });

    it('should create groups with a custom validator', () => {
      const g = b.group(
          {'login': 'some value'}, {'validator': syncValidator, 'asyncValidator': asyncValidator});

      expect(g.validator).toBe(syncValidator);
      expect(g.asyncValidator).toBe(asyncValidator);
    });

    it('should create control arrays', () => {
      const c = b.control('three');
      const e = b.control(null);
      const f = b.control(undefined);
      const a = b.array(
          ['one', ['two', syncValidator], c, b.array(['four']), e, f], syncValidator,
          asyncValidator);

      expect(a.value).toEqual(['one', 'two', 'three', ['four'], null, null]);
      expect(a.validator).toBe(syncValidator);
      expect(a.asyncValidator).toBe(asyncValidator);
    });

    it('should create control arrays with multiple async validators', fakeAsync(() => {
         function asyncValidator1() { return of ({'async1': true}); }
         function asyncValidator2() { return of ({'async2': true}); }

         const a = b.array(['one', 'two'], null, [asyncValidator1, asyncValidator2]);
         expect(a.value).toEqual(['one', 'two']);

         tick();

         expect(a.errors).toEqual({'async1': true, 'async2': true});
       }));

    it('should create control arrays with multiple sync validators', () => {
      function syncValidator1() { return {'sync1': true}; }
      function syncValidator2() { return {'sync2': true}; }

      const a = b.array(['one', 'two'], [syncValidator1, syncValidator2]);
      expect(a.value).toEqual(['one', 'two']);
      expect(a.errors).toEqual({'sync1': true, 'sync2': true});
    });

    describe('updateOn', () => {
      it('should default to on change', () => {
        const c = b.control('');
        expect(c.updateOn).toEqual('change');
      });

      it('should default to on change with an options obj', () => {
        const c = b.control('', {validators: Validators.required});
        expect(c.updateOn).toEqual('change');
      });

      it('should set updateOn when updating on blur', () => {
        const c = b.control('', {updateOn: 'blur'});
        expect(c.updateOn).toEqual('blur');
      });

      describe('in groups and arrays', () => {
        it('should default to group updateOn when not set in control', () => {
          const g = b.group({one: b.control(''), two: b.control('')}, {updateOn: 'blur'});

          expect(g.get('one') !.updateOn).toEqual('blur');
          expect(g.get('two') !.updateOn).toEqual('blur');
        });

        it('should default to array updateOn when not set in control', () => {
          const a = b.array([b.control(''), b.control('')], {updateOn: 'blur'});

          expect(a.get([0]) !.updateOn).toEqual('blur');
          expect(a.get([1]) !.updateOn).toEqual('blur');
        });

        it('should set updateOn with nested groups', () => {
          const g = b.group(
              {
                group: b.group({one: b.control(''), two: b.control('')}),
              },
              {updateOn: 'blur'});

          expect(g.get('group.one') !.updateOn).toEqual('blur');
          expect(g.get('group.two') !.updateOn).toEqual('blur');
          expect(g.get('group') !.updateOn).toEqual('blur');
        });

        it('should set updateOn with nested arrays', () => {
          const g = b.group(
              {
                arr: b.array([b.control(''), b.control('')]),
              },
              {updateOn: 'blur'});

          expect(g.get(['arr', 0]) !.updateOn).toEqual('blur');
          expect(g.get(['arr', 1]) !.updateOn).toEqual('blur');
          expect(g.get('arr') !.updateOn).toEqual('blur');
        });

        it('should allow control updateOn to override group updateOn', () => {
          const g = b.group(
              {one: b.control('', {updateOn: 'change'}), two: b.control('')}, {updateOn: 'blur'});

          expect(g.get('one') !.updateOn).toEqual('change');
          expect(g.get('two') !.updateOn).toEqual('blur');
        });

        it('should set updateOn with complex setup', () => {
          const g = b.group({
            group: b.group(
                {one: b.control('', {updateOn: 'change'}), two: b.control('')}, {updateOn: 'blur'}),
            groupTwo: b.group({one: b.control('')}, {updateOn: 'submit'}),
            three: b.control('')
          });

          expect(g.get('group.one') !.updateOn).toEqual('change');
          expect(g.get('group.two') !.updateOn).toEqual('blur');
          expect(g.get('groupTwo.one') !.updateOn).toEqual('submit');
          expect(g.get('three') !.updateOn).toEqual('change');
        });
      });
    });
  });
})();