feat(aigle): add inspection functions

lib/aigle.js

@@ -52,13 +52,6 @@ class Aigle extends AigleCore {
     this._execute(executor);
   }
 
-  /**
-   * @return {string}
-   */
-  toString() {
-    return '[object Promise]';
-  }
-
   /**
    * @param {Function} onFulfilled
    * @param {Function} [onRejected]
@@ -99,6 +92,41 @@ class Aigle extends AigleCore {
     return addAigle(this, new Aigle(INTERNAL), handler, handler);
   }
 
+  /**
+   * @return {string}
+   */
+  toString() {
+    return '[object Promise]';
+  }
+
+  /**
+   * @return {boolean}
+   */
+  isPending() {
+    return this._resolved === 0;
+  }
+
+  /**
+   * @return {boolean}
+   */
+  isFulfilled() {
+    return this._resolved === 1;
+  }
+
+  /**
+   * @return {boolean}
+   */
+  isRejected() {
+    return this._resolved === 2;
+  }
+
+  /**
+   * @return {boolean}
+   */
+  isCancelled() {
+    return this._value instanceof CancellationError;
+  }
+
   /**
    * @example
    * const { CancellationError } = Aigle;

test/.eslintrc

@@ -1,3 +1,5 @@
+env:
+  mocha: true
 parserOptions:
   ecmaVersion: 8
 rules:

test/lib/test.promise.js

@@ -719,3 +719,33 @@ parallel('#toString', () => {
     assert.strictEqual(promise.toString(), '[object Promise]');
   });
 });
+
+parallel('#isPending', () => {
+
+  it('should return true if a promise is pending', () => {
+
+    const promise = new Aigle(() => {});
+    assert.strictEqual(promise.isPending(), true);
+  });
+
+  it('should return false if a promise is fulfilled', () => {
+
+    const promise = Aigle.resolve();
+    assert.strictEqual(promise.isPending(), false);
+  });
+});
+
+parallel('#isFulfilled', () => {
+
+  it('should return false if a promise is pending', () => {
+
+    const promise = new Aigle(() => {});
+    assert.strictEqual(promise.isFulfilled(), false);
+  });
+
+  it('should return true if a promise is fulfilled', () => {
+
+    const promise = Aigle.resolve();
+    assert.strictEqual(promise.isFulfilled(), true);
+  });
+});