summaryrefslogtreecommitdiff
path: root/modules/CanonicalJSON.jsm
diff options
context:
space:
mode:
authorMatt A. Tobin <email@mattatobin.com>2021-11-19 08:40:33 -0500
committerMatt A. Tobin <email@mattatobin.com>2021-11-19 08:40:33 -0500
commit654faab56fe2888db29dec3140537b571a1ee1dd (patch)
tree96f1d1494ea23f30900884a53b7ba9702362dc43 /modules/CanonicalJSON.jsm
parent410d228eaa229067de8bb3a359e0ca80a4dd6066 (diff)
downloadaura-central-654faab56fe2888db29dec3140537b571a1ee1dd.tar.gz
Issue %3005 - Move toolkit/modules to modules/
- Also builds libmar from modules/
Diffstat (limited to 'modules/CanonicalJSON.jsm')
-rw-r--r--modules/CanonicalJSON.jsm62
1 files changed, 62 insertions, 0 deletions
diff --git a/modules/CanonicalJSON.jsm b/modules/CanonicalJSON.jsm
new file mode 100644
index 000000000..ae754ff3a
--- /dev/null
+++ b/modules/CanonicalJSON.jsm
@@ -0,0 +1,62 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this file,
+ * You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+this.EXPORTED_SYMBOLS = ["CanonicalJSON"];
+
+const { classes: Cc, interfaces: Ci, utils: Cu } = Components;
+
+Cu.import("resource://gre/modules/XPCOMUtils.jsm");
+XPCOMUtils.defineLazyModuleGetter(this, "jsesc",
+ "resource://gre/modules/third_party/jsesc/jsesc.js");
+
+this.CanonicalJSON = {
+ /**
+ * Return the canonical JSON form of the passed source, sorting all the object
+ * keys recursively. Note that this method will cause an infinite loop if
+ * cycles exist in the source (bug 1265357).
+ *
+ * @param source
+ * The elements to be serialized.
+ *
+ * The output will have all unicode chars escaped with the unicode codepoint
+ * as lowercase hexadecimal.
+ *
+ * @usage
+ * CanonicalJSON.stringify(listOfRecords);
+ **/
+ stringify: function stringify(source) {
+ if (Array.isArray(source)) {
+ const jsonArray = source.map(x => typeof x === "undefined" ? null : x);
+ return `[${jsonArray.map(stringify).join(",")}]`;
+ }
+
+ if (typeof source === "number") {
+ if (source === 0) {
+ return (Object.is(source, -0)) ? "-0" : "0";
+ }
+ }
+
+ // Leverage jsesc library, mainly for unicode escaping.
+ const toJSON = (input) => jsesc(input, {lowercaseHex: true, json: true});
+
+ if (typeof source !== "object" || source === null) {
+ return toJSON(source);
+ }
+
+ // Dealing with objects, ordering keys.
+ const sortedKeys = Object.keys(source).sort();
+ const lastIndex = sortedKeys.length - 1;
+ return sortedKeys.reduce((serial, key, index) => {
+ const value = source[key];
+ // JSON.stringify drops keys with an undefined value.
+ if (typeof value === "undefined") {
+ return serial;
+ }
+ const jsonValue = value && value.toJSON ? value.toJSON() : value;
+ const suffix = index !== lastIndex ? "," : "";
+ const escapedKey = toJSON(key);
+ return serial + `${escapedKey}:${stringify(jsonValue)}${suffix}`;
+ }, "{") + "}";
+ },
+};