Migration Guide (#2419)

* Migration Guide

Migration guide from JerryScript 1.0 to 2.0.

Co-authored-by: László Langó llango.u-szeged@partner.samsung.com
Co-authored-by: Peter Gal pgal.u-szeged@partner.samsung.com
JerryScript-DCO-1.0-Signed-off-by: Istvan Miklos imiklos2@inf.u-szeged.hu

* Add version information for API methods

For each API method/type the documentation now includes
the version it was introduced or a change occured.

JerryScript-DCO-1.0-Signed-off-by: Peter Gal pgal.u-szeged@partner.samsung.com
This commit is contained in:
Istvan Miklos
2019-07-25 20:33:03 +02:00
committed by Robert Fancsik
parent d3c78d8c6a
commit 7575fa454a
4 changed files with 954 additions and 0 deletions
+179
View File
@@ -11,6 +11,8 @@ Enum that contains the following elements:
- JERRY_INIT_MEM_STATS_SEPARATE - **deprecated**, dump memory statistics and reset peak values after parse
- JERRY_INIT_DEBUGGER - **deprecated**, an unused placeholder now
*Changed in version 2.0*: JERRY_INIT_MEM_STATS_SEPARATE and JERRY_INIT_DEBUGGER are now deprecated and not used internally.
## jerry_type_t
Enum that contains JerryScript API value types:
@@ -26,6 +28,8 @@ Enum that contains JerryScript API value types:
- JERRY_TYPE_ERROR - error/abort type
- JERRY_TYPE_SYMBOL - symbol type
*New in version 2.0*.
## jerry_error_t
Possible types of an error:
@@ -41,6 +45,8 @@ Possible types of an error:
There is also a special value `JERRY_ERROR_NONE` which is not an error type
this value can only be returned by the [jerry_get_error_type](#jerry_get_error_type).
*Changed in version 2.0*: The `JERRY_ERROR_NONE` was added to be used by the [jerry_get_error_type](#jerry_get_error_type) method.
## jerry_feature_t
Possible compile time enabled feature types:
@@ -65,6 +71,8 @@ Possible compile time enabled feature types:
- JERRY_FEATURE_SYMBOL - symbol support
- JERRY_FEATURE_DATAVIEW - DataView support
*New in version 2.0*.
## jerry_regexp_flags_t
RegExp object optional flags:
@@ -75,6 +83,8 @@ RegExp object optional flags:
multiple lines (i.e., match the beginning or end of each line (delimited by \n or \r), not only the
very beginning or end of the whole input string)
*New in version 2.0*.
## jerry_parse_opts_t
Option bits for [jerry_parse](#jerry_parse) and
@@ -83,6 +93,8 @@ Option bits for [jerry_parse](#jerry_parse) and
- JERRY_PARSE_NO_OPTS - no options passed
- JERRY_PARSE_STRICT_MODE - enable strict mode
*New in version 2.0*.
## jerry_gc_mode_t
Set garbage collection operational mode
@@ -95,6 +107,8 @@ is that the former keeps memory allocated for performance improvements such
as property hash tables for large objects. The latter frees all possible
memory blocks but the performance may drop after the garbage collection.
*New in version 2.0*.
## jerry_generate_snapshot_opts_t
Flags for [jerry_generate_snapshot](#jerry_generate_snapshot) and
@@ -123,6 +137,8 @@ strings are set by [jerry_register_magic_strings](#jerry_register_magic_strings)
when the snapshot is generated and executed. Furthermore the
`JERRY_SNAPSHOT_EXEC_COPY_DATA` option is not allowed.
*New in version 2.0*.
## jerry_exec_snapshot_opts_t
Flags for [jerry_exec_snapshot](#jerry_exec_snapshot) and
@@ -143,6 +159,7 @@ parts of the snapshot buffer into memory.
The `JERRY_SNAPSHOT_EXEC_COPY_DATA` option is not allowed for static snapshots.
*New in version 2.0*.
## jerry_char_t
@@ -254,6 +271,8 @@ typedef struct
} jerry_context_data_manager_t;
```
*New in version 2.0*.
## jerry_context_alloc_t
**Summary**
@@ -269,6 +288,7 @@ typedef void *(*jerry_context_alloc_t) (size_t size, void *cb_data_p);
- `size` - allocation size
- `cb_data_p` - pointer to user data
*New in version 2.0*.
## jerry_context_t
@@ -282,6 +302,8 @@ An opaque declaration of the JerryScript context structure.
typedef struct jerry_context_t jerry_context_t;
```
*New in version 2.0*.
## jerry_binary_operation_t
@@ -294,6 +316,8 @@ Enum that contains the supported binary operation types
- JERRY_BIN_OP_GREATER_EQUAL - greater or equal relation (>=)
- JERRY_BIN_OP_INSTANCEOF - instanceof operation
*New in version 2.0*.
**See also**
- [jerry_binary_operation](#jerry_binary_operation)
@@ -378,6 +402,8 @@ typedef struct
} jerry_heap_stats_t;
```
*New in version 2.0*.
**See also**
- [jerry_get_memory_stats](#jerry_get_memory_stats)
@@ -420,6 +446,8 @@ Native free callback of an object. It is used in `jerry_object_native_info_t` an
typedef void (*jerry_object_native_free_callback_t) (void *native_p);
```
*New in version 2.0*: Renamed from `jerry_object_free_callback_t`.
**See also**
- [jerry_object_native_info_t](#jerry_object_native_info_t)
@@ -450,6 +478,8 @@ typedef struct
} jerry_object_native_info_t;
```
*New in version 2.0*.
**See also**
- [jerry_set_object_native_pointer](#jerry_set_object_native_pointer)
@@ -503,6 +533,8 @@ typedef bool (*jerry_objects_foreach_t) (const jerry_value_t object,
- true, to continue the iteration
- false, to stop the iteration
*New in version 2.0*.
**See also**
- [jerry_objects_foreach](#jerry_objects_foreach)
@@ -530,6 +562,8 @@ typedef bool (*jerry_objects_foreach_by_native_info_t) (const jerry_value_t obje
- true, to continue the iteration
- false, to stop the iteration
*New in version 2.0*.
**See also**
- [jerry_objects_foreach_by_native_info](#jerry_objects_foreach_by_native_info)
@@ -551,6 +585,8 @@ In this case the function must throw the same error again.
typedef jerry_value_t (*jerry_vm_exec_stop_callback_t) (void *user_p);
```
*New in version 2.0*.
**See also**
- [jerry_set_vm_exec_stop_callback](#jerry_set_vm_exec_stop_callback)
@@ -575,6 +611,8 @@ Possible values:
API functions can return the `JERRY_TYPEDARRAY_INVALID` value if the
TypedArray support is not in the engine.
*New in version 2.0*.
**See also**
- [jerry_get_typedarray_type](#jerry_get_typedarray_type)
@@ -666,6 +704,8 @@ jerry_get_context_data (const jerry_context_data_manager *manager_p);
by `manager_p`, which will be stored for future identical calls to `jerry_get_context_data ()`, and which will be
deinitialized using the `deinit_cb` callback provided by `manager_p` when the context will be destroyed.
*New in version 2.0*.
**Example**
[doctest]: # (test="compile")
@@ -746,6 +786,8 @@ jerry_register_magic_strings (const jerry_char_t * const *ex_str_items_p,
- `count` - number of elements in `ext_str_items_p` array
- `str_lengths_p` - array of lengths for each magic string
*Changed in version 2.0*: The first function argument type was changed.
**Example**
[doctest]: # ()
@@ -810,6 +852,8 @@ jerry_get_memory_stats (jerry_heap_stats_t *out_stats_p);
- true, if stats were written into the `out_stats_p` pointer.
- false, otherwise. Usually it is because the `JERRY_FEATURE_MEM_STATS` feature is not enabled.
*New in version 2.0*.
**Example**
```c
@@ -840,6 +884,8 @@ jerry_gc (jerry_gc_mode_t mode);
- `mode` - operational mode, see [jerry_gc_mode_t](#jerry_gc_mode_t)
*Changed in version 2.0*: Added `mode` argument.
**Example**
[doctest]: # ()
@@ -949,6 +995,8 @@ jerry_parse (const jerry_char_t *resource_name_p, /**< resource name (usually a
- function object value, if script was parsed successfully,
- thrown error, otherwise
*Changed in version 2.0*: Added `resource_name_p`, and `resource_name_length` arguments.
**Example**
[doctest]: # ()
@@ -1014,6 +1062,7 @@ jerry_parse_function (const jerry_char_t *resource_name_p, /**< resource name (u
- function object value, if script was parsed successfully,
- thrown error, otherwise
*New in version 2.0*.
**Example**
@@ -1208,6 +1257,8 @@ jerry_run_all_enqueued_jobs (void)
- return value - result of last executed job, may be error value.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -1296,6 +1347,8 @@ jerry_value_is_abort (const jerry_value_t value);
- true, if the given `jerry_value_t` has the error and abort value set
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -1379,6 +1432,8 @@ jerry_value_is_arraybuffer (const jerry_value_t value)
- true, if the given `jerry_value_t` is an ArrayBuffer object.
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -1502,6 +1557,8 @@ jerry_value_is_dataview (const jerry_value_t value)
- true, if the given `jerry_value_t` is a DataView object
- false, otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -1554,6 +1611,8 @@ jerry_value_is_error (const jerry_value_t value);
- true, if the given `jerry_value_t` is error value.
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -1756,6 +1815,8 @@ jerry_value_is_promise (const jerry_value_t value)
- true, if the given `jerry_value_t` is a promise
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -1841,6 +1902,8 @@ jerry_value_is_symbol (const jerry_value_t value)
- true, if the given `jerry_value_t` is a symbol
- false, otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -1899,6 +1962,8 @@ jerry_value_is_typedarray (const jerry_value_t value)
- true, if the given `jerry_value_t` is a TypedArray object.
- false, otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -1991,6 +2056,8 @@ jerry_value_get_type (const jerry_value_t value);
- return value
- One of the [jerry_type_t](#jerry_type_t) value.
*New in version 2.0*.
**Example**
```c
@@ -2030,6 +2097,8 @@ jerry_is_feature_enabled (const jerry_feature_t feature);
- true, if the given `jerry_feature_t` is enabled
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -2077,6 +2146,8 @@ jerry_binary_operation (jerry_binary_operation_t op,
- error, if argument has an error flag or operation is unsuccessful or unsupported
- true/false, the result of the binary operation on the given operands otherwise
*New in version 2.0*.
**Example - JERRY_BIN_OP_EQUAL**
```c
@@ -2168,6 +2239,8 @@ main (void)
# Error manipulation functions
*Changed in version 2.0*: The error handling and manipulation was modified and the old methods were replaced.
## jerry_create_abort_from_value
**Summary**
@@ -2192,6 +2265,8 @@ jerry_create_abort_from_value (jerry_value_t value, bool release);
- `release` - raw boolean, defines whether input value must be released
- return value - abort (api) value
*New in version 2.0*.
**Example 1**
```c
@@ -2251,6 +2326,8 @@ jerry_create_error_from_value (jerry_value_t value, bool release);
- `release` - raw boolean, defines whether input value must be released
- return value - error (api) value
*New in version 2.0*.
**Example 1**
```c
@@ -2311,6 +2388,8 @@ jerry_get_error_type (const jerry_value_t value);
- JERRY_ERROR_NONE if the input is not an error object
- one of the [jerry_error_t](#jerry_error_t) value
*New in version 2.0*.
**Example**
```c
@@ -2358,6 +2437,8 @@ jerry_get_value_from_error (jerry_value_t value, bool release)
- `release` - raw boolean, defines whether input value must be released
- return value - api value
*New in version 2.0*.
**Example 1**
```c
@@ -2545,6 +2626,8 @@ jerry_get_utf8_string_size (const jerry_value_t value);
- `value` - api value
- return value - number of bytes in the buffer needed to represent the utf8-encoded string.
*New in version 2.0*.
**Example**
```c
@@ -2631,6 +2714,8 @@ jerry_get_utf8_string_length (const jerry_value_t value);
- `value` - input string value
- return value - number of characters in the string
*New in version 2.0*.
**Example**
```c
@@ -2760,6 +2845,8 @@ jerry_string_to_utf8_char_buffer (const jerry_value_t value,
- `buffer_size` - size of the buffer
- return value - number of bytes, actually copied to the buffer
*New in version 2.0*.
**Example**
```c
@@ -2815,6 +2902,8 @@ jerry_substring_to_char_buffer (const jerry_value_t value,
- `buffer_size` - size of the buffer
- return value - number of bytes, actually copied to the buffer
*New in version 2.0*.
**Example**
```c
@@ -2872,6 +2961,8 @@ jerry_substring_to_utf8_char_buffer (const jerry_value_t value,
- `buffer_size` - size of the buffer
- return value - number of bytes, actually copied to the buffer
*New in version 2.0*.
**Example**
```c
@@ -3167,6 +3258,8 @@ jerry_resolve_or_reject_promise (jerry_value_t promise,
- undefined jerry value - resolve or reject successed
- jerry value with error flag - otherwise
*New in version 2.0*.
**Example**
```c
@@ -3230,6 +3323,8 @@ jerry_get_symbol_descriptive_string (const jerry_value_t value);
- string value containing the symbol's descriptive string - if success
- thrown error, otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -3397,6 +3492,8 @@ jerry_create_arraybuffer (jerry_length_t size);
- `size` - size of the ArrayBuffer to create **in bytes**
- return value - the new ArrayBuffer as a `jerry_value_t`
*New in version 2.0*.
**Example**
```c
@@ -3449,6 +3546,8 @@ jerry_create_arraybuffer_external (const jerry_length_t size
- the new ArrayBuffer as a `jerry_value_t`
- if the `size` is zero or `buffer_p` is a null pointer will return RangeError
*New in version 2.0*.
**Example**
```c
@@ -3620,6 +3719,8 @@ jerry_create_dataview (const jerry_value_t array_buffer,
- value of the constructed DataView object - if success
- created error - otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -3927,6 +4028,8 @@ jerry_create_promise (void)
- return value - value of the newly created promise
*New in version 2.0*.
**Example**
```c
@@ -4045,6 +4148,8 @@ jerry_create_string_from_utf8 (const jerry_char_t *str_p);
- `str_p` - pointer to string
- return value - value of the created string
*New in version 2.0*.
**Example**
```c
@@ -4086,6 +4191,8 @@ jerry_create_string_sz (const jerry_char_t *str_p,
- `str_size` - size of the string
- return value - value of the created string
*New in version 2.0*.
**Example**
```c
@@ -4131,6 +4238,8 @@ jerry_create_symbol (const jerry_value_t value)
- value of the created symbol, if success
- thrown error, otherwise
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -4184,6 +4293,8 @@ jerry_create_regexp (const jerry_char_t *pattern_p, uint16_t flags);
- `flags` - optional flags for the RegExp object, see [jerry_regexp_flags_t](#jerry_regexp_flags_t)
- return value - the RegExp object as a `jerry_value_t`
*New in version 2.0*.
**Example**
```c
@@ -4222,6 +4333,8 @@ jerry_create_regexp_sz (const jerry_char_t *pattern_p, jerry_size_t pattern_size
- `flags` - optional flags for the RegExp object, see [jerry_regexp_flags_t](#jerry_regexp_flags_t)
- return value - the RegExp object as a `jerry_value_t`
*New in version 2.0*.
**Example**
```c
@@ -4267,6 +4380,8 @@ jerry_create_typedarray (jerry_typedarray_type_t type_name, jerry_length_t item_
- `item_count` - number of items in the new TypedArray
- return value - the new TypedArray as a `jerry_value_t`
*New in version 2.0*.
**Example**
```c
@@ -4324,6 +4439,8 @@ jerry_create_typedarray_for_arraybuffer (jerry_typedarray_type_t type_name,
- the new TypedArray as a `jerry_value_t`
- Error if the ArrayBuffer does not have enough space for the given type of TypedArray
*New in version 2.0*.
**Example**
```c
@@ -4387,6 +4504,8 @@ jerry_create_typedarray_for_arraybuffer_sz (jerry_typedarray_type_t type_name,
- the new TypedArray as a `jerry_value_t`
- Error if the ArrayBuffer does not have enough space for the given type of TypedArray
*New in version 2.0*.
**Example**
```c
@@ -4465,6 +4584,8 @@ jerry_has_property (const jerry_value_t obj_val,
- true, if the property exists
- false, otherwise
*Changed in version 2.0*: The return value type is now a JavaScript value and not a primitive boolean value.
**Example**
[doctest]: # ()
@@ -4522,6 +4643,8 @@ jerry_has_own_property (const jerry_value_t obj_val,
- true, if the property exists
- false, otherwise
*Changed in version 2.0*: The return value type is now a JavaScript value and not a primitive boolean value.
**Example**
[doctest]: # ()
@@ -4619,6 +4742,8 @@ jerry_delete_property_by_index (const jerry_value_t obj_val,
- true, if property was deleted successfully
- false, otherwise
*New in version 2.0*.
**Example**
```c
@@ -5437,6 +5562,8 @@ jerry_get_object_native_pointer (const jerry_value_t obj_val,
- true, if there is native pointer associated of the specified object with the given native type info
- false, otherwise
*New in version 2.0*: Changed from `jerry_get_object_native_handle`.
**Example**
[doctest]: # ()
@@ -5646,6 +5773,8 @@ jerry_set_object_native_pointer (const jerry_value_t obj_val,
be a long-lived pointer, usually a pointer to a
`static const jerry_object_native_info_t` makes most sense.
*New in version 2.0*: Changed from `jerry_set_object_native_handle`.
**Example**
See [jerry_get_object_native_pointer](#jerry_get_object_native_pointer) for a
@@ -5679,6 +5808,8 @@ jerry_delete_object_native_pointer (const jerry_value_t obj_val,
- `obj_val` - object to delete native pointer from.
- `info_p` - native pointer's type information.
*New in version 2.0*.
**Example**
See [jerry_get_object_native_pointer](#jerry_get_object_native_pointer) for a
@@ -5821,6 +5952,8 @@ jerry_objects_foreach (jerry_objects_foreach_t foreach_p,
- `true`, if the search function terminated the traversal by returning `false`
- `false`, if the end of the list of objects was reached
*New in version 2.0*.
**Example**
[doctest]: # (name="02.API-REFERENCE-objects-foreach.c")
@@ -5958,6 +6091,8 @@ jerry_objects_foreach_by_native_info (const jerry_object_native_info_t *native_i
- `true`, if the search function terminated the traversal by returning `false`
- `false`, if the end of the list of objects was reached
*New in version 2.0*.
**Example**
[doctest]: # (name="02.API-REFERENCE-objects-foreach-nativeptr.c")
@@ -6112,6 +6247,8 @@ jerry_is_valid_utf8_string (const jerry_char_t *utf8_buf_p, /**< UTF-8 string */
- true, if the provided string was a valid UTF-8 string.
- false, if the string is not valid as an UTF-8 string.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -6167,6 +6304,8 @@ jerry_is_valid_cesu8_string (const jerry_char_t *cesu8_buf_p, /**< CESU-8 string
- true, if the provided string was a valid CESU-8 string.
- false, if the string is not valid as a CESU-8 string.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -6229,6 +6368,8 @@ void *jerry_heap_alloc (size_t size);
- return value: non-NULL pointer, if the memory is successfully allocated,
NULL otherwise.
*New in version 2.0*.
**See also**
- [jerry_heap_free](#jerry_heap_free)
@@ -6248,6 +6389,8 @@ void jerry_heap_free (void *mem_p, size_t size);
- `mem_p`: value returned by `jerry_heap_alloc`.
- `size`: same size as passed to `jerry_heap_alloc`.
*New in version 2.0*.
**See also**
- [jerry_heap_alloc](#jerry_heap_alloc)
@@ -6277,6 +6420,8 @@ jerry_create_context (uint32_t heap_size,
- pointer to the newly created JerryScript context if success
- NULL otherwise.
*New in version 2.0*.
**Example**
[doctest]: # (test="compile")
@@ -6389,6 +6534,8 @@ jerry_generate_snapshot (const jerry_char_t *resource_name_p,
current configuration through JERRY_SNAPSHOT_SAVE)
- thrown error, otherwise.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -6472,6 +6619,8 @@ jerry_generate_function_snapshot (const jerry_char_t *resource_name_p,
current configuration through JERRY_SNAPSHOT_SAVE)
- thrown error, otherwise.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -6542,6 +6691,8 @@ jerry_exec_snapshot (const uint32_t *snapshot_p,
- result of bytecode, if run was successful
- thrown error, otherwise
*Changed in version 2.0*: Added `func_index` and `exec_snapshot_opts` arguments. Removed the `copy_bytecode` last argument.
**Example**
[doctest]: # ()
@@ -6620,6 +6771,8 @@ jerry_load_function_snapshot (const uint32_t *snapshot_p,
- function object built from the snapshot.
- thrown error, otherwise.
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -6714,6 +6867,8 @@ jerry_get_literals_from_snapshot (const uint32_t *snapshot_p,
and literal-save support is enabled in current configuration through JERRY_SNAPSHOT_SAVE)
- 0 otherwise.
*New in version 2.0*.
**Example**
[doctest]: # (test="link")
@@ -6802,6 +6957,8 @@ jerry_set_vm_exec_stop_callback (jerry_vm_exec_stop_callback_t stop_cb,
- `user_p` - user pointer passed to the `stop_cb` function
- `frequency` - frequency of calling the `stop_cb` function
*New in version 2.0*.
**Example**
[doctest]: # (test="link")
@@ -6877,6 +7034,8 @@ jerry_get_backtrace (uint32_t max_depth);
- return value
- a newly constructed JS array
*New in version 2.0*.
**Example**
[doctest]: # (name="02.API-REFERENCE-jsbacktrace.c")
@@ -6993,6 +7152,8 @@ jerry_get_arraybuffer_byte_length (const jerry_value_t value);
- size of the ArrayBuffer in bytes
- 0 if the `value` parameter is not an ArrayBuffer
*New in version 2.0*.
**Example**
```c
@@ -7043,6 +7204,8 @@ jerry_arraybuffer_read (const jerry_value_t value,
- 0 if the `value` is not an ArrayBuffer object
- 0 if the `buf_size` is zero or there is nothing to read
*New in version 2.0*.
**Example**
```c
@@ -7105,6 +7268,8 @@ jerry_arraybuffer_write (const jerry_value_t value,
- 0 if the `value` is not an ArrayBuffer object
- 0 if the `buf_size` is zero or there is nothing to write
*New in version 2.0*.
**Example**
```c
@@ -7165,6 +7330,8 @@ jerry_get_arraybuffer_pointer (const jerry_value_t value);
- pointer to the Array Buffer's data area.
- NULL if the `value` is not an Array Buffer object.
*New in version 2.0*.
**Example**
```c
@@ -7218,6 +7385,8 @@ jerry_get_dataview_buffer (const jerry_value_t value,
- DataView object's underlying ArrayBuffer object
- TypeError if the `value` is not a DataView object
*New in version 2.0*.
**Example**
[doctest]: # ()
@@ -7276,6 +7445,8 @@ jerry_get_typedarray_type (jerry_value_t value);
- the type of the TypedArray
- JERRY_TYPEDARRAY_INVALID if the object was not a TypedArray
*New in version 2.0*.
**Example**
```c
@@ -7317,6 +7488,8 @@ jerry_get_typedarray_length (jerry_value_t value);
- length (element count) of the TypedArray object
- 0 if the object is not a TypedArray
*New in version 2.0*.
**Example**
```c
@@ -7366,6 +7539,8 @@ jerry_get_typedarray_buffer (jerry_value_t value,
- TypedArray object's underlying ArrayBuffer object
- TypeError if the `value` is not a TypedArray object
*New in version 2.0*.
**Example**
```c
@@ -7411,6 +7586,8 @@ jerry_json_parse (const jerry_char_t *string_p,
- jerry_value_t containing the same as json.parse()
- jerry_value_t containing error massage
*New in version 2.0*.
**Example**
```c
@@ -7442,6 +7619,8 @@ jerry_json_stringify (const jerry_value_t object_to_stringify);
- jerry_value_t containing the same as json.stringify()
- jerry_value_t containing error massage
*New in version 2.0*.
**Example**
```c