【Flutter】利用Future封装出js中的Promise

前端的同学对Promise肯定都很熟悉,而Future便是dartPromise,但方法名称和使用方式还是有些许的差异的。
下面我们尝试,利用Future封装出js中我们熟悉的Promise

Javascript Promise 参考

https://es6.ruanyifeng.com/#docs/promise

实现Promise的基本用法

import 'dart:async';

class Promise {
  Future future;

  Promise(dynamic excutor(dynamic resolve(val), dynamic reject(val))) {
    if (!(excutor is Function)) {
      throw new AssertionError('Promise resolver $excutor is not a function');
    }
    final completer = Completer();
    try {
      excutor(completer.complete, completer.completeError);
    } catch (e) {
      completer.completeError(e);
    }
    this.future = completer.future;
  }

  /// Promise链式回调,对应Dart [.then]
  Future then(Future Function(dynamic) onValue, {Function onError}) {
    return this.future?.then(onValue, onError: onError);
  }

  /// Promise链式回调,对应Dart [.catchError]
  Future catch_(Function onError, {bool Function(Object) test}) {
    return this.future?.catchError(onError, test: test);
  }

  /// Promise链式回调,对应Dart [.whenComplete]
  Future finally_(Future<dynamic> Function() action) {
    return this.future?.whenComplete(action);
  }
}

使用示例

Promise promise = Promise((resolve,reject){
  // ... some code

  if (/* 异步操作成功 */){
    resolve(value);
  } else {
    reject(error);
  }
})

// 链式回调
promise
   .then((value) => null)
   .catch_((error) => null)
   .finally_((action) => null);

// 如果要使用dart的 async/await 需要先获取到 Promise 实例内的 Future
dynamic result = await promise.future;

Futrue中有对应实现的方法

Promise.all, Promise.race, Promise.resolve, Promise.reject

class Promise{
  /// 用于将多个 Future 实例,包装成一个新的 Future 实例。
  /// 等待[futures]完成并收集其结果。
  static Future all(Iterable<Future> futures) => Future.wait(futures);

  /// 对应Dart [Future.any]
  /// 返回[futures]中成功完成的第一个future的结果。
  /// 任意失败都会导致抛出异常
  static Future race(Iterable<Future> futures) => Future.any(futures);

  /// 对应Dart [Future.value]
  static Future resolve(dynamic value) => Future.value(value);

  /// 对应Dart [Future.error]
  static Future reject(dynamic value) => Future.error(value);
}

Futrue中有无对应实现的方法

Promise.allSettled方法接受一组 Promise 实例作为参数,包装成一个新的 Promise 实例。只有等到所有这些参数实例都返回结果,不管是fulfilled还是rejected,包装实例才会结束。该方法由 ES2020 引入

class Promise{
  static final String FULFILLED = 'fulfilled';
  static final String REJECTED = 'rejected';

  /// 用于将多个 Future 实例,包装成一个新的 Future 实例。
  /// 不论成功失败,都返回结果
  static Future allSettled(Iterable<Future> futures) {
    List<dynamic> result = List.generate(futures.length, (index) => null);
    final completer = Completer();

    for (int i = 0; i < futures.length; i++) {
      futures.elementAt(i).then((value) {
        result[i] = {'status': FULFILLED, 'value': value};
      }).catchError((error) {
        result[i] = {'status': REJECTED, 'reason': error};
      }).whenComplete(() {
        if (result.every((element) => element != null)) {
          return completer.complete(result);
        }
      });
    }

    return completer.future;
  }
}

Promise.any()方法接受一组 Promise 实例作为参数,包装成一个新的 Promise 实例。只要参数实例有一个变成fulfilled状态,包装实例就会变成fulfilled状态;如果所有参数实例都变成rejected状态,包装实例就会变成rejected状态。该方法目前是一个第三阶段的提案

Promise.any()Promise.race()方法很像,只有一点不同,就是不会因为某个 Promise 变成rejected状态而结束。

class Promise{
  /// 返回[futures]中成功完成的第一个future的结果;
  /// 全部失败才会抛出异常
  /// ```
  /// @param futures {Iterable<Future>} Future 实例组
  /// @param onlyError {bool} 是否只抛出最后一个异常结果,否则抛出一个异常 List ,默认 false
  /// ```
  static Future any(Iterable<Future> futures, {bool onlyError = false}) async {
    List<dynamic> errors = [];
    final completer = Completer();

    for (int i = 0; i < futures.length; i++) {
      futures.elementAt(i).then((value) {
        completer.complete(value);
      }).catchError((error) {
        errors[i] = error;
        if (futures.length == errors.length) {
          completer.completeError(onlyError ? error : errors);
        }
      });
    }

    return completer.future;
  }
}

顺便把延迟函数也封装一下,毕竟毫秒延迟的使用频率是最高的。

class Promise{
  static Future sleep(int ms) => Future.delayed(Duration(milliseconds: ms));
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,539评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,911评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,337评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,723评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,795评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,762评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,742评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,508评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,954评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,247评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,404评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,104评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,736评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,352评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,557评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,371评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,292评论 2 352

推荐阅读更多精彩内容

  • 原创性声明:本文完全为笔者原创,请尊重笔者劳动力。转载务必注明原文地址。 发现有一段时间没有写文章了,中了一段时间...
    东方一号蓝阅读 693评论 0 1
  • 你不知道JS:异步 第三章:Promises 接上篇3-1 错误处理(Error Handling) 在异步编程中...
    purple_force阅读 1,393评论 0 2
  • 1. Promise 的含义 所谓Promise,简单说就是一个容器,里面保存着某个未来才会结束的事件(通常是一个...
    ROBIN2015阅读 488评论 0 0
  • 本文是整理阮一峰大神ES6中 Promise 的学习笔记 目录: Promise.prototype.then()...
    叫我王必过阅读 247评论 0 2
  • 早上上班时,有搞售后的张师来办公室串门。 因问起他最近的一笔生意,他说应该问题不大。我遂与他开玩笑说:...
    雪里梅香阅读 264评论 1 1