feat(User): add #isAuthenticated, deprecate #authenticated (#393)

Author: leeyeh

src/user.js

@@ -516,13 +516,37 @@ module.exports = function(AV) {
 
     /**
      * Checks whether this user is the current user and has been authenticated.
+     * @deprecated 如果要判断当前用户的登录状态是否有效，请使用 currentUser.isAuthenticated().then()，
+     * 如果要判断该用户是否是当前登录用户，请使用 user.id === currentUser.id
      * @return (Boolean) whether this user is the current user and is logged in.
      */
     authenticated: function() {
+      console.warn('DEPRECATED: 如果要判断当前用户的登录状态是否有效，请使用 currentUser.isAuthenticated().then()，如果要判断该用户是否是当前登录用户，请使用 user.id === currentUser.id。')
       return !!this._sessionToken &&
           (!AV._config.disableCurrentUser && AV.User.current() && AV.User.current().id === this.id);
     },
 
+    /**
+     * 检查该用户的登录状态是否有效，请注意该方法会校验 sessionToken 的有效性，是个异步方法。
+     *
+     * @since 2.0.0
+     * @return Promise.<Boolean>
+     */
+    isAuthenticated() {
+      return Promise.resolve().then(() =>
+        !!this._sessionToken &&
+        AV.User._fetchUserBySessionToken(this._sessionToken).then(
+          () => true,
+          (error) => {
+            if (error.code === 211) {
+              return false;
+            }
+            throw error;
+          }
+        )
+      );
+    },
+
     /**
      * Get sessionToken of current user.
      * @return {String} sessionToken

test/user.js

@@ -44,6 +44,7 @@ describe("User", function() {
         expect(theUser.get("username")).to.be(username);
       });
     });
+    
 
     it("should fail with wrong password", function() {
       return AV.User.logIn(username, 'wrong password')
@@ -57,12 +58,32 @@ describe("User", function() {
 
 
   describe("Current User", function() {
-    it("should return current user", function() {
-
+    it("current()", function() {
       var currentUser = AV.User.current();
       expect(currentUser).to.be.ok();
-      return AV.User.currentAsync().then(function(user) {
+    });
+    it('currentAsync()', () =>
+      AV.User.currentAsync().then(function(user) {
         expect(user).to.be.ok();
+      })
+    );
+  });
+  
+  describe('authenticated', () => {
+    it('authenticated()', () => {
+      AV.User.current().authenticated().should.be.ok();
+      new AV.User().authenticated().should.not.be.ok();
+    });
+    describe('isAuthenticated', () => {
+      it('currentUser.isAuthenticated()', () =>
+        AV.User.current().isAuthenticated().should.be.fulfilledWith(true)
+      );
+      it('user.isAuthenticated()', () =>
+        new AV.User().isAuthenticated().should.be.fulfilledWith(false)
+      );
+      it('outdated sessionToken', () => {
+        AV.User.current()._sessionToken = '0';
+        return new AV.User.current().isAuthenticated().should.be.fulfilledWith(false)
       });
     });
   });