initial commit

2026-06-25 21:30:32 +00:00
commit 328faf6251
220 changed files with 162103 additions and 0 deletions
@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright The Closure Library Authors.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+
+/**
+ * @fileoverview Utility to attempt native JSON processing, falling back to
+ *     goog.json if not available.
+ *
+ *     This is intended as a drop-in for current users of goog.json who want
+ *     to take advantage of native JSON if present.
+ */
+
+goog.provide('goog.json.hybrid');
+
+goog.require('goog.asserts');
+goog.require('goog.json');
+
+
+/**
+ * Attempts to serialize the JSON string natively, falling back to
+ * `goog.json.serialize` if unsuccessful.
+ * @param {!Object} obj JavaScript object to serialize to JSON.
+ * @return {string} Resulting JSON string.
+ */
+goog.json.hybrid.stringify = goog.json.USE_NATIVE_JSON ?
+    goog.global['JSON']['stringify'] :
+    function(obj) {
+      'use strict';
+      if (goog.global.JSON) {
+        try {
+          return goog.global.JSON.stringify(obj);
+        } catch (e) {
+          // Native serialization failed.  Fall through to retry with
+          // goog.json.serialize.
+        }
+      }
+
+      return goog.json.serialize(obj);
+    };
+
+
+/**
+ * Attempts to parse the JSON string natively, falling back to
+ * the supplied `fallbackParser` if unsuccessful.
+ * @param {string} jsonString JSON string to parse.
+ * @param {function(string):Object} fallbackParser Fallback JSON parser used
+ *     if native
+ * @return {?Object} Resulting JSON object.
+ * @private
+ */
+goog.json.hybrid.parse_ = function(jsonString, fallbackParser) {
+  'use strict';
+  if (goog.global.JSON) {
+    try {
+      var obj = goog.global.JSON.parse(jsonString);
+      goog.asserts.assert(typeof obj == 'object');
+      return /** @type {?Object} */ (obj);
+    } catch (e) {
+      // Native parse failed.  Fall through to retry with goog.json.parse.
+    }
+  }
+
+  return fallbackParser(jsonString);
+};
+
+
+/**
+ * Attempts to parse the JSON string natively, falling back to
+ * `goog.json.parse` if unsuccessful.
+ * @param {string} jsonString JSON string to parse.
+ * @return {?Object} Resulting JSON object.
+ */
+goog.json.hybrid.parse = goog.json.USE_NATIVE_JSON ?
+    goog.global['JSON']['parse'] :
+    function(jsonString) {
+      'use strict';
+      return goog.json.hybrid.parse_(jsonString, goog.json.parse);
+    };