summaryrefslogtreecommitdiffstats
path: root/js/src/builtin/JSON.h
diff options
context:
space:
mode:
Diffstat (limited to 'js/src/builtin/JSON.h')
-rw-r--r--js/src/builtin/JSON.h63
1 files changed, 63 insertions, 0 deletions
diff --git a/js/src/builtin/JSON.h b/js/src/builtin/JSON.h
new file mode 100644
index 0000000000..fd2d65e4f7
--- /dev/null
+++ b/js/src/builtin/JSON.h
@@ -0,0 +1,63 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+ * vim: set ts=8 sts=2 et sw=2 tw=80:
+ * 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/. */
+
+#ifndef builtin_JSON_h
+#define builtin_JSON_h
+
+#include "mozilla/Range.h"
+
+#include "NamespaceImports.h"
+
+#include "js/RootingAPI.h"
+
+namespace js {
+
+class StringBuffer;
+
+extern const JSClass JSONClass;
+
+enum class StringifyBehavior {
+ // Attempt an optimistic fast path if possible, bailing back to the slow path
+ // if anything is encountered that could invalidate the fast path results per
+ // spec. Default behavior for non-DEBUG builds.
+ Normal,
+
+ // Handle a subset of functionality when called by JS::ToJSONMaybeSafely.
+ // Different restrictions than the fast path described for Normal. See the
+ // Stringify() comment below for details.
+ RestrictedSafe,
+
+ // If the fast path fails, throw an exception instead of falling back to the
+ // slow path. Useful for testing that something that should be handled by the
+ // fast path actually is.
+ FastOnly,
+
+ // Do not attempt the fast path. Useful for timing comparisons.
+ SlowOnly,
+
+ // Attempt to run both the fast and slow paths and compare the results,
+ // crashing on any discrepancy. For correctness testing only. Default behavior
+ // when DEBUG is defined.
+ Compare
+};
+
+/**
+ * If stringifyBehavior is RestrictedSafe, Stringify will attempt to assert the
+ * API requirements of JS::ToJSONMaybeSafely as it traverses the graph, and will
+ * not try to invoke .toJSON on things as it goes.
+ */
+extern bool Stringify(JSContext* cx, js::MutableHandleValue vp,
+ JSObject* replacer, const Value& space, StringBuffer& sb,
+ StringifyBehavior stringifyBehavior);
+
+template <typename CharT>
+extern bool ParseJSONWithReviver(JSContext* cx,
+ const mozilla::Range<const CharT> chars,
+ HandleValue reviver, MutableHandleValue vp);
+
+} // namespace js
+
+#endif /* builtin_JSON_h */