feat: AV.parse & AV.stringify

Author: leeyeh

src/av.js

@@ -250,13 +250,29 @@ AV._decode = function(value, key) {
 
 /**
  * The inverse function of {@link AV.Object#toFullJSON}.
- * @since 2.0.0
+ * @since 3.0.0
  * @method
  * @param {Object}
  * return {AV.Object|AV.File|any}
  */
 AV.parseJSON = AV._decode;
 
+/**
+ * Similar to JSON.parse, except that AV internal types will be used if possible.
+ * Inverse to {@link AV.stringify}
+ * @since 3.14.0
+ * @param {string} text the string to parse.
+ * @return {AV.Object|AV.File|any}
+ */
+AV.parse = text => AV.parseJSON(JSON.parse(text));
+/**
+ * Serialize a target containing AV.Object, similar to JSON.stringify.
+ * Inverse to {@link AV.parse}
+ * @since 3.14.0
+ * @return {string}
+ */
+AV.stringify = target => JSON.stringify(AV._encode(target, [], false, true));
+
 AV._encodeObjectOrArray = function(value) {
   var encodeAVObject = function(object) {
     if (object && object._toFullJSON) {

src/file.js

@@ -233,7 +233,7 @@ module.exports = function(AV) {
       /**
        * Returns a JSON version of the file with meta data.
        * Inverse to {@link AV.parseJSON}
-       * @since 2.0.0
+       * @since 3.0.0
        * @return {Object}
        */
       toFullJSON(seenObjects = []) {

src/object.js

@@ -250,7 +250,7 @@ module.exports = function(AV) {
       /**
        * Returns a JSON version of the object with meta data.
        * Inverse to {@link AV.parseJSON}
-       * @since 2.0.0
+       * @since 3.0.0
        * @return {Object}
        */
       toFullJSON(seenObjects = []) {

storage.d.ts

@@ -1161,6 +1161,8 @@ export function setServerURLs(urls: string | ServerURLs): void;
 export function setProduction(production: boolean): void;
 export function setRequestTimeout(ms: number): void;
 export function parseJSON(json: any): Object | File | any;
+export function parse(text: string): Object | File | any;
+export function stringify(target: Object | File | any): string;
 export function request(options: {
   method: string;
   path: string;

test/object.js

@@ -109,7 +109,7 @@ describe('Objects', function() {
       });
     });
 
-    it('toJSON and parse', () => {
+    it('toJSON and parseJSON', () => {
       const json = gameScore.toJSON();
       json.objectId.should.eql(gameScore.id);
       json.id.should.eql(gameScore.get('id'));
@@ -120,6 +120,17 @@ describe('Objects', function() {
       parsedGameScore.get('score').should.eql(gameScore.get('score'));
     });
 
+    it('stringify and parse', () => {
+      const text = AV.stringify(gameScore);
+      console.log(text);
+      const parsedGameScore = AV.parse(text);
+      console.log(parsedGameScore);
+      parsedGameScore.should.be.instanceof(GameScore);
+      parsedGameScore.id.should.eql(gameScore.id);
+      parsedGameScore.get('id').should.eql(gameScore.get('id'));
+      parsedGameScore.get('score').should.eql(gameScore.get('score'));
+    });
+
     it('toJSON and parse (User)', () => {
       const user = new AV.Object.createWithoutData('_User', 'objectId');
       user.set('id', 'id');