Expose JSON stringifier through V8 API

include/v8.h

 // Copyright 2012 the V8 project authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /** \mainpage V8 API Reference Guide
  *
  * V8 is Google's open source JavaScript engine.
  *
  * This set of documents provides reference material generated from the
  * V8 header file, include/v8.h.
@@ skipping 1647 matching lines @@
 
 
 // The output structure filled up by GetStackSample API function.
 struct SampleInfo {
   size_t frames_count;
   StateTag vm_state;
 };
 
 
 /**
  * A JSON Parser.

[Toon Verwaest, 2016/04/04 10:43:39]

This isn't just a parser anymore now.

  */
 class V8_EXPORT JSON {
  public:
   /**
    * Tries to parse the string |json_string| and returns it as value if
    * successful.
    *
    * \param json_string The string to parse.
    * \return The corresponding value if successfully parsed.
    */
   static V8_DEPRECATED("Use maybe version",
                        Local<Value> Parse(Local<String> json_string));
   static V8_WARN_UNUSED_RESULT MaybeLocal<Value> Parse(
       Isolate* isolate, Local<String> json_string);
+
+  /**
+   * Tries to stringify the JSON-serializable object |json_object| and returns
+   * it as string if successful.
+   *
+   * \param json_object The JSON-serializable object to stringify.
+   * \return The corresponding string if successfully stringified.
+   */
+  static V8_WARN_UNUSED_RESULT MaybeLocal<String> Stringify(
+      Isolate* isolate, Local<Object> json_object);

[Toon Verwaest, 2016/04/04 10:43:39]

Shouldn't this get the context as input, like v8::Object::Get? Probably the same
for Parse above.

[Yang, 2016/04/04 10:55:43]

The parser should definitely get a context as argument since the object it
creates is context-specific.

Not so sure about the stringifier though, as the returned string is
context-independent. But we probably do want access checks during stringifying
to check for the correct context?

 };
 
 
 /**
  * A map whose keys are referenced weakly. It is similar to JavaScript WeakMap
  * but can be created without entering a v8::Context and hence shouldn't
  * escape to JavaScript.
  */
 class V8_EXPORT NativeWeakMap : public Data {
  public:
@@ skipping 7054 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // INCLUDE_V8_H_