feat: allow to set some default fetching options to a query.

spec/suite/query.spec.js

@@ -121,6 +121,18 @@ describe("Query", function() {
 
   });
 
+  describe(".fetchOptions()", function() {
+
+    it("gets/sets the fetching options", function() {
+
+      expect(this.query.fetchOptions().return).toBe('entity');
+      this.query.fetchOptions({ return: 'array' });
+      expect(this.query.fetchOptions().return).toBe('array');
+
+    });
+
+  });
+
   describe(".get()", function() {
 
     it("finds all records", function(done) {

src/query.js

@@ -86,6 +86,14 @@ class Query {
      */
     this._page = [];
 
+
+    /**
+     * Default fetch options.
+     *
+     * @var Object
+     */
+    this._fetchOptions = {};
+
     var schema = this.schema();
 
     /**
@@ -138,6 +146,20 @@ class Query {
     return this._statement;
   }
 
+  /**
+   * Get/set default fetch options.
+   *
+   * @param  Object|null $fetchOptions The fetching options.
+   * @return Object.
+   */
+  fetchOptions(fetchOptions) {
+    if (arguments.length) {
+      this._fetchOptions = fetchOptions;
+      return this;
+    }
+    return Object.assign({ return: 'entity' }, this._fetchOptions);
+  }
+
   /**
    * Executes the query and returns the result.
    *
@@ -146,10 +168,7 @@ class Query {
    */
   get(options) {
     return co(function*(){
-      var defaults = {
-        return: 'entity'
-      };
-      options = extend({}, defaults, options);
+      options = extend({}, this.fetchOptions(), options);
 
       this._applyHas();
       this._applyLimit();