JerryScript 2.0

[zherczeg]

It would be good to release JerryScript 2.0 this year. No specific deadline so far.

What we should do before that is reworking the API. Some ideas:

• delete obsolote functions
• rework error flag to be an error value (error can only be a result of something, and cannot be used as input except unboxing its value).

[martijnthe]

delete obsolote functions

Which ones are those?

Quick search for "deprecated" through the code base revealed:

JERRY_DEPRECATED_API
bool jerry_get_object_native_handle (const jerry_value_t obj_val, uintptr_t *out_handle_p);
JERRY_DEPRECATED_API
void jerry_set_object_native_handle (const jerry_value_t obj_val, uintptr_t handle_p,
                                     jerry_object_free_callback_t freecb_p);

#pragma message ("using jerry-api.h directly is deprecated, please use jerryscript.h")

#pragma message ("using jerry-port.h directly is deprecated, please use jerryscript-port.h")

  JERRY_INIT_MEM_STATS_SEPARATE  = (1u << 3), /**< deprecated, an unused placeholder now */
  JERRY_INIT_DEBUGGER            = (1u << 4), /**< deprecated, an unused placeholder now */

Anything else (other than the "old"/current error flag APIs)?

[zherczeg]

Mostly these. Maybe the parse variant where the source is not provided, but that is not necessary. We should emphasize that pass source info if available, and pass NULL if not.

It will be a much smaller scope API rework that JerryScript 1.0.

[galpeter]

I've got a few suggestions for extra API functions/improvements:

• JSON C API - parse/stringify
• Regex construction from API / maybe even exec/test
• Allow jerry_is_feature_enabled to query builtin/es2015-subset objects
• Add DataView for es2015-subset

please note I'm not sure how widely they would be used or needed.

[galpeter]

(IMHO) If we want to remove functions we should mark them as obsolete as a first step. This way we can (hopefully) notify the users that there will be a bigger change. Related to this I think we should consider writing a migration guide or at least a change list between v1 and v2.

[zherczeg]

Snapshot generation API rework #2259

Lets just collect the API rework patches here, and later we can write a changelog using these references.

[zherczeg]

Snapshot executing API rework #2270

[zherczeg]

Jerry parse rework: #2282

[imiklos]

Rename the jerry_value_has_error_flag function: #2290

[imiklos]

Rename the jerry_value_has_abort_flag function #2291

[zherczeg]

Replace the jerry_value_set_error_flag function with jerry_create_error_from_value #2367