Support object.exists()

integration/test/ParseObjectTest.js

@@ -80,6 +80,14 @@ describe('Parse Object', () => {
     });
   });
 
+  it('can check if object exists', async () => {
+    const object = new TestObject();
+    await object.save();
+    assert.equal(await object.exists(), true);
+    await object.destroy();
+    assert.equal(await object.exists(), false);
+  });
+
   it('can find objects', (done) => {
     const object = new TestObject({ foo: 'bar' });
     object.save().then(() => {

src/ParseObject.js

@@ -933,6 +933,27 @@ class ParseObject {
     return false;
   }
 
+  /**
+   * Returns true if this object exists on the Server
+   *
+   * @param {Object} options
+   * Valid options are:<ul>
+   *   <li>useMasterKey: In Cloud Code and Node only, causes the Master Key to
+   *     be used for this request.
+   *   <li>sessionToken: A valid session token, used for making a request on
+   *       behalf of a specific user.
+   * </ul>
+   * @return {Promise<boolean>} A boolean promise that is fulfilled if object exists.
+   */
+  async exists(options?: RequestOptions): Promise<boolean> {
+    try {
+      await this.fetch(options);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+
   /**
    * Checks if the model is currently in a valid state.
    * @return {Boolean}

src/__tests__/ParseObject-test.js

@@ -1109,6 +1109,22 @@ describe('ParseObject', () => {
     spy.mockRestore();
   });
 
+  it('can check if object exists', async () => {
+    const objectController = CoreManager.getObjectController();
+    const spy = jest.spyOn(
+      objectController,
+      'fetch'
+    )
+      .mockImplementationOnce(() => Promise.resolve())
+      .mockImplementationOnce(() => Promise.reject());
+
+    const parent = new ParseObject('Person');
+    expect(await parent.exists()).toBe(true);
+    expect(await parent.exists()).toBe(false);
+
+    spy.mockRestore();
+  });
+
   it('can save the object', (done) => {
     CoreManager.getRESTController()._setXHR(
       mockXHR([{