angular异步验证防抖踩坑实录

前言

本周的一个需求是在一个异步验证上加上防抖，防抖，以前也接触过，依稀记得不难，就没再去看angluar的官方文档，直接就开始google写了，然后……一不小心就掉坑里了。

突然没了效果的验证功能

在网上一番查询以后，选了一个最简单，最符合的实现

一番修改以后我的代码成了下面这样

 public oldPasswordValidator(): AsyncValidatorFn {
  return (ctrl: AbstractControl): Promise<ValidationErrors | null> | Observable<ValidationErrors | null> => {
  rerutn ctrl.valueChanges.pipe(
    debounceTime(2000),
    distinctUntilChanged(),
    switchMap(value => this.checkPasswordIsRight(value)),
    map((isRight: boolean) => (isRight ? null : {passwordError: true})),
    catchError(() => null));
  };

但是验证器并没有效果，在c层获取到的始终是null，而在方法中打印结果，却可以发现，能够产生正确的结果

但是获取到的相关错误一直是没有,更让我感到惊讶的是表单的valid和invalid竟然同时处在了false,他们不是应该互斥吗？不是反义词吗？

FormControl的status

首先还是解决valid与invalid的疑惑吧,查询官方文档。

FormControl的status继承自AbstractControl

AbstractControl是 FormControl、FormGroup 和 FormArray 的基类。它提供了一些所有控件和控件组共有的行为，比如运行验证器、计算状态和重置状态。 它还定义了一些所有子类共享的属性，如 value、valid 和 dirty。不允许直接实例化它。

找到valid

至此，这个疑问解决了，互斥的并不仅仅是valid和invalid,

还有一个检查进行状态：pending和禁止disable,验证一下，果然此时的状态是在pending

为何会一直在pending状态？

接着查看表单验证的官方文档

自定义异步验证器和同步验证器很像，只是它们必须返回一个稍后会输出 null 或“验证错误对象”的承诺（Promise）或可观察对象，如果是可观察对象，那么它必须在某个时间点被完成（complete），那时候这个表单就会使用它输出的最后一个值作为验证结果。（译注：HTTP 服务是自动完成的，但是某些自定义的可观察对象可能需要手动调用 complete 方法)
返回的可观察对象必须是有限的，也就是说，它必须在某个时间点结束（complete）。要把无尽的可观察对象转换成有限的，可以使用 first、last、take 或 takeUntil 等过滤型管道对其进行处理。

结果很明显了，上面的观察者对象是通过valueChangs产生的, 被人订阅后，并不会主动的调用complete()方法，而会不停的发布新值。下面的例子可以看出来

给他加个first()让他只返回第一个结果,果然好使了：

first(predicate: function(value: T, index: number, source: Observable<T>): boolean, resultSelector:function(value: T, index: number): R, defaultValue: R): Observable<T | R>
只发出由源 Observable 所发出的值中第一个(或第一个满足条件的值)。

如果你足够细心

看的太不仔细了，到解决这个问题之前，一直都没发现……

一个更简单的实现方式

验证的防抖功能实际上并不需要通过上面的方式实现，尽管上面也并不困难。

最简单的防抖方式，在官方文档已经提供了:

默认情况下，每当表单值变化之后，都会执行所有验证器。对于同步验证器，没有什么会显著影响应用性能的地方。不过，异步验证器通常会执行某种 HTTP 请求来对控件进行验证。如果在每次按键之后都发出 HTTP 请求会给后端 API 带来沉重的负担，应该尽量避免。

我们可以把updateOn属性从change（默认值）改成submit或blur来推迟表单验证的更新时机。

 /**
  * 初始化表单
  */
 initForm() {
  this.modifyPasswordForm = this.fb.group({
    oldPassword: [null, [Validators.required], [this.userService.oldPasswordValidator()]],
    newPassword: [null, Validators.required],
    confirmNewPassword: [null, Validators.required]

    // updateOn 作用是在什么时候更新表单数据
    // https://angular.cn/guide/form-validation#note-on-performance
   }, {updateOn: 'blur'},
  );
 }

想了解更多updateOn的内容，可查看这篇文章。

总结

这次的问题可以完全说出在了看文档不仔细，神奇的是看了几遍那个StackOverflow上的回答都没发现他比我多了一个first(),虽然因此浪费了不少的时间，但收获也是巨大的，这波不亏。