diff --git a/docs/10.EXT-REFERENCE-HANDLER.md b/docs/10.EXT-REFERENCE-HANDLER.md index 7a30b0231a..e9c6060e18 100644 --- a/docs/10.EXT-REFERENCE-HANDLER.md +++ b/docs/10.EXT-REFERENCE-HANDLER.md @@ -421,6 +421,9 @@ For example usage see [jerryx_set_properties](#jerryx_set_properties). Hard assert for scripts. The routine calls `jerry_port_fatal` on assertion failure. +If the `JERRY_FEATURE_LINE_INFO` runtime feature is enabled (build option: `JERRY_LINE_INFO`) +a backtrace is also printed out. + **Prototype** ```c diff --git a/jerry-ext/handler/handler-assert.c b/jerry-ext/handler/handler-assert.c index 5cea272608..6b1b7f371a 100644 --- a/jerry-ext/handler/handler-assert.c +++ b/jerry-ext/handler/handler-assert.c @@ -16,9 +16,15 @@ #include "jerryscript-ext/handler.h" #include "jerryscript-port.h" +#include + /** * Hard assert for scripts. The routine calls jerry_port_fatal on assertion failure. * + * Notes: + * * If the `JERRY_FEATURE_LINE_INFO` runtime feature is enabled (build option: `JERRY_LINE_INFO`) + * a backtrace is also printed out. + * * @return true - if only one argument was passed and that argument was a boolean true. * Note that the function does not return otherwise. */ @@ -38,7 +44,52 @@ jerryx_handler_assert_fatal (const jerry_value_t func_obj_val, /**< function obj return jerry_create_boolean (true); } + /* Assert failed, print a bit of JS backtrace */ jerry_port_log (JERRY_LOG_LEVEL_ERROR, "Script Error: assertion failed\n"); + + if (jerry_is_feature_enabled (JERRY_FEATURE_LINE_INFO)) + { + jerry_port_log (JERRY_LOG_LEVEL_ERROR, "Script backtrace (top 5):\n"); + + /* If the line info feature is disabled an empty array will be returned. */ + jerry_value_t backtrace_array = jerry_get_backtrace (5); + uint32_t array_length = jerry_get_array_length (backtrace_array); + + for (uint32_t idx = 0; idx < array_length; idx++) + { + jerry_value_t property = jerry_get_property_by_index (backtrace_array, idx); + + jerry_length_t total_size = jerry_get_utf8_string_size (property); + jerry_length_t current_size = 0; + jerry_char_t string_buffer[64]; + const jerry_length_t copy_size = (jerry_length_t) (sizeof (string_buffer) - 1); + + /* On some systems the uint32_t values can't be printed with "%u" and + * on some systems it can be printed. To avoid differences in the uint32_t typdef + * The "PRIu32" macro is used to correctly add the formatter. + */ + jerry_port_log (JERRY_LOG_LEVEL_ERROR, " %"PRIu32": ", idx); + do + { + jerry_size_t copied_bytes = jerry_substring_to_utf8_char_buffer (property, + current_size, + current_size + copy_size, + string_buffer, + copy_size); + string_buffer[copied_bytes] = '\0'; + jerry_port_log (JERRY_LOG_LEVEL_ERROR, "%s", string_buffer); + + current_size += copied_bytes; + } + while (total_size != current_size); + jerry_port_log (JERRY_LOG_LEVEL_ERROR, "\n"); + + jerry_release_value (property); + } + + jerry_release_value (backtrace_array); + } + jerry_port_fatal (ERR_FAILED_INTERNAL_ASSERTION); } /* jerryx_handler_assert_fatal */