mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
ac1c48eeff
Notable changes:
- Updated and the port API interface, new functions have been added
and some have been changed. The port library is now cleaned up to
not have any dependency on jerry-core, as it should be. The port library
is now strictly a collection of functions that implement
embedding/platform specific behavior.
- The default port implementation has been split for windows and unix.
Implemented port functions have been categorized and reorganized,
and marked with attribute((weak)) for better reusability.
- External context allocation has been moved to the port API instead
of a core API callback. The iterface has also been extended with a
function to free the allocated context. When external context is
enabled, jerry_init now automatically calls the port implementation
to allocate the context and jerry_cleanup automatically calls the port
to free the context.
- jerry_port_log has been changed to no longer require formatting to
be implemented by the port. The reason beind this is that it was vague what
format specifiers were used by the engine, and in what manner. The port
function now takes a zero-terminated string, and should only implement
how the string should be logged.
- Logging and log message formatting is now handled by the core jerry library
where it can be implemented as necessary. Logging can be done through a new
core API function, which uses the port to output the final log message.
- Log level has been moved into jerry-core, and an API function has
been added to set the log level. It should be the library that
filters log messages based on the requested log level, instead of
logging everything and requiring the user to do so.
- Module resolving logic has been moved into jerry-core. There's no
reason to have it in the port library and requiring embedders to
duplicate the code. It also added an unnecessary dependency on
jerry-core to the port. Platform specific behavior is still used through
the port API, like resolving module specifiers, and reading source file
contents. If necessary, the resolving logic can still be overridden as
previously.
- The jerry-ext library has also been cleaned up, and many utility
functions have been added that previously were implemented in
jerry-main. This allows easier reusability for some common operations,
like printing unhandled exceptions or providing a repl console.
- Debugger interaction with logged/printed messages has been fixed, so
that it's no longer the port implementations responsibility to send
the output to the debugger, as the port should have no notion of what a
debugger is. The printing and logging functions will now pass the
result message to the debugger, if connected.
- Cleaned up TZA handling in the date port implementation, and simplified
the API function prototype.
- Moved property access helper functions that use ASCII strings as
keys from jerry-ext to the core API.
JerryScript-DCO-1.0-Signed-off-by: Dániel Bátyai dbatyai@inf.u-szeged.hu
1210 lines
29 KiB
C
1210 lines
29 KiB
C
/* Copyright JS Foundation and other contributors, http://js.foundation
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef JERRYSCRIPT_CORE_H
|
|
#define JERRYSCRIPT_CORE_H
|
|
|
|
#include "jerryscript-types.h"
|
|
|
|
JERRY_C_API_BEGIN
|
|
|
|
/**
|
|
* @defgroup jerry-api JerryScript public API
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-general General functions
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-general-conext Context management
|
|
* @{
|
|
*/
|
|
void jerry_init (jerry_init_flag_t flags);
|
|
void jerry_cleanup (void);
|
|
|
|
void *jerry_context_data (const jerry_context_data_manager_t *manager_p);
|
|
|
|
jerry_value_t jerry_current_realm (void);
|
|
jerry_value_t jerry_set_realm (jerry_value_t realm);
|
|
/**
|
|
* jerry-api-general-conext @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-general-heap Heap management
|
|
* @{
|
|
*/
|
|
void *jerry_heap_alloc (jerry_size_t size);
|
|
void jerry_heap_free (void *mem_p, jerry_size_t size);
|
|
|
|
bool jerry_heap_stats (jerry_heap_stats_t *out_stats_p);
|
|
void jerry_heap_gc (jerry_gc_mode_t mode);
|
|
|
|
bool jerry_foreach_live_object (jerry_foreach_live_object_cb_t callback, void *user_data);
|
|
bool jerry_foreach_live_object_with_info (const jerry_object_native_info_t *native_info_p,
|
|
jerry_foreach_live_object_with_info_cb_t callback,
|
|
void *user_data_p);
|
|
/**
|
|
* jerry-api-general-heap @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-general-misc Miscellaneous
|
|
* @{
|
|
*/
|
|
|
|
void JERRY_ATTR_FORMAT (printf, 2, 3) jerry_log (jerry_log_level_t level, const char *format_p, ...);
|
|
void jerry_log_set_level (jerry_log_level_t level);
|
|
bool jerry_validate_string (const jerry_char_t *buffer_p, jerry_size_t buffer_size, jerry_encoding_t encoding);
|
|
bool JERRY_ATTR_CONST jerry_feature_enabled (const jerry_feature_t feature);
|
|
void jerry_register_magic_strings (const jerry_char_t *const *ext_strings_p,
|
|
uint32_t count,
|
|
const jerry_length_t *str_lengths_p);
|
|
/**
|
|
* jerry-api-general-misc @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-general @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-code Scripts and Executables
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-code-parse Parsing
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_parse (const jerry_char_t *source_p, size_t source_size, const jerry_parse_options_t *options_p);
|
|
jerry_value_t jerry_parse_value (const jerry_value_t source, const jerry_parse_options_t *options_p);
|
|
/**
|
|
* jerry-api-code-parse @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-code-exec Execution
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_eval (const jerry_char_t *source_p, size_t source_size, uint32_t flags);
|
|
jerry_value_t jerry_run (const jerry_value_t script);
|
|
jerry_value_t jerry_run_jobs (void);
|
|
/**
|
|
* jerry-api-code-exec @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-code-sourceinfo Source information
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_source_name (const jerry_value_t value);
|
|
jerry_value_t jerry_source_user_value (const jerry_value_t value);
|
|
jerry_source_info_t *jerry_source_info (const jerry_value_t value);
|
|
void jerry_source_info_free (jerry_source_info_t *source_info_p);
|
|
/**
|
|
* jerry-api-code-sourceinfo @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-code-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_halt_handler (uint32_t interval, jerry_halt_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-code-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-code @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-backtrace Backtraces
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-backtrace-capture Capturing
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_backtrace (uint32_t max_depth);
|
|
void jerry_backtrace_capture (jerry_backtrace_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-backtrace-capture @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-backtrace-frame Frames
|
|
* @{
|
|
*/
|
|
jerry_frame_type_t jerry_frame_type (const jerry_frame_t *frame_p);
|
|
const jerry_value_t *jerry_frame_callee (jerry_frame_t *frame_p);
|
|
const jerry_value_t *jerry_frame_this (jerry_frame_t *frame_p);
|
|
const jerry_frame_location_t *jerry_frame_location (jerry_frame_t *frame_p);
|
|
bool jerry_frame_is_strict (jerry_frame_t *frame_p);
|
|
/**
|
|
* jerry-api-backtrace-frame @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-backtrace @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-value Values
|
|
* @{
|
|
*/
|
|
|
|
/* Reference management */
|
|
jerry_value_t JERRY_ATTR_WARN_UNUSED_RESULT jerry_value_copy (const jerry_value_t value);
|
|
void jerry_value_free (jerry_value_t value);
|
|
|
|
/**
|
|
* @defgroup jerry-api-value-checks Type inspection
|
|
* @{
|
|
*/
|
|
jerry_type_t jerry_value_type (const jerry_value_t value);
|
|
bool jerry_value_is_exception (const jerry_value_t value);
|
|
bool jerry_value_is_abort (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_undefined (const jerry_value_t value);
|
|
bool jerry_value_is_null (const jerry_value_t value);
|
|
bool jerry_value_is_boolean (const jerry_value_t value);
|
|
bool jerry_value_is_true (const jerry_value_t value);
|
|
bool jerry_value_is_false (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_number (const jerry_value_t value);
|
|
bool jerry_value_is_bigint (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_string (const jerry_value_t value);
|
|
bool jerry_value_is_symbol (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_object (const jerry_value_t value);
|
|
bool jerry_value_is_array (const jerry_value_t value);
|
|
bool jerry_value_is_promise (const jerry_value_t value);
|
|
bool jerry_value_is_proxy (const jerry_value_t value);
|
|
bool jerry_value_is_arraybuffer (const jerry_value_t value);
|
|
bool jerry_value_is_shared_arraybuffer (const jerry_value_t value);
|
|
bool jerry_value_is_dataview (const jerry_value_t value);
|
|
bool jerry_value_is_typedarray (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_constructor (const jerry_value_t value);
|
|
bool jerry_value_is_function (const jerry_value_t value);
|
|
bool jerry_value_is_async_function (const jerry_value_t value);
|
|
|
|
bool jerry_value_is_error (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-value-checks @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-value-coerce Coercion
|
|
* @{
|
|
*/
|
|
bool jerry_value_to_boolean (const jerry_value_t value);
|
|
jerry_value_t jerry_value_to_number (const jerry_value_t value);
|
|
jerry_value_t jerry_value_to_object (const jerry_value_t value);
|
|
jerry_value_t jerry_value_to_primitive (const jerry_value_t value);
|
|
jerry_value_t jerry_value_to_string (const jerry_value_t value);
|
|
jerry_value_t jerry_value_to_bigint (const jerry_value_t value);
|
|
|
|
double jerry_value_as_number (const jerry_value_t value);
|
|
double jerry_value_as_integer (const jerry_value_t value);
|
|
int32_t jerry_value_as_int32 (const jerry_value_t value);
|
|
uint32_t jerry_value_as_uint32 (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-value-coerce @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-value-op Operations
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_binary_op (jerry_binary_op_t operation, const jerry_value_t lhs, const jerry_value_t rhs);
|
|
|
|
/**
|
|
* jerry-api-value-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-value @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-exception Exceptions
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-exception-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_throw (jerry_error_t type, const jerry_value_t message);
|
|
jerry_value_t jerry_throw_sz (jerry_error_t type, const char *message_p);
|
|
jerry_value_t jerry_throw_value (jerry_value_t value, bool take_ownership);
|
|
jerry_value_t jerry_throw_abort (jerry_value_t value, bool take_ownership);
|
|
/**
|
|
* jerry-api-exception-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-exception-op Operations
|
|
* @{
|
|
*/
|
|
void jerry_exception_allow_capture (jerry_value_t value, bool allow_capture);
|
|
/**
|
|
* jerry-api-exception-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-exception-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_exception_value (jerry_value_t value, bool free_exception);
|
|
bool jerry_exception_is_captured (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-exception-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-exception-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_on_throw (jerry_throw_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-exception-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-error @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-primitives Primitive types
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-undefined Undefined
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-undefined-ctor Constructors
|
|
* @{
|
|
*/
|
|
|
|
jerry_value_t JERRY_ATTR_CONST jerry_undefined (void);
|
|
|
|
/**
|
|
* jerry-api-undefined-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-undefined @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-null Null
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-null-ctor Constructors
|
|
* @{
|
|
*/
|
|
|
|
jerry_value_t JERRY_ATTR_CONST jerry_null (void);
|
|
|
|
/**
|
|
* jerry-api-null-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-null @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-boolean Boolean
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-boolean-ctor Constructors
|
|
* @{
|
|
*/
|
|
|
|
jerry_value_t JERRY_ATTR_CONST jerry_boolean (bool value);
|
|
|
|
/**
|
|
* jerry-api-boolean-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-boolean @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-number Number
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-number-ctor Number
|
|
* @{
|
|
*/
|
|
|
|
jerry_value_t jerry_number (double value);
|
|
jerry_value_t jerry_infinity (bool sign);
|
|
jerry_value_t jerry_nan (void);
|
|
|
|
/**
|
|
* jerry-api-number-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-number @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-bigint BigInt
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-bigint-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_bigint (const uint64_t *digits_p, uint32_t digit_count, bool sign);
|
|
/**
|
|
* jerry-api-bigint-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-bigint-get Getters
|
|
* @{
|
|
*/
|
|
uint32_t jerry_bigint_digit_count (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-bigint-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-bigint-op Operations
|
|
* @{
|
|
*/
|
|
void jerry_bigint_to_digits (const jerry_value_t value, uint64_t *digits_p, uint32_t digit_count, bool *sign_p);
|
|
/**
|
|
* jerry-api-bigint-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-bigint @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-string String
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-string-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_string (const jerry_char_t *buffer_p, jerry_size_t buffer_size, jerry_encoding_t encoding);
|
|
jerry_value_t jerry_string_sz (const char *str_p);
|
|
jerry_value_t jerry_string_external (const jerry_char_t *buffer_p, jerry_size_t buffer_size, void *user_p);
|
|
jerry_value_t jerry_string_external_sz (const char *str_p, void *user_p);
|
|
/**
|
|
* jerry-api-string-cotr @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-string-get Getters
|
|
* @{
|
|
*/
|
|
jerry_size_t jerry_string_size (const jerry_value_t value, jerry_encoding_t encoding);
|
|
jerry_length_t jerry_string_length (const jerry_value_t value);
|
|
void *jerry_string_user_ptr (const jerry_value_t value, bool *is_external);
|
|
/**
|
|
* jerry-api-string-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-string-op Operations
|
|
* @{
|
|
*/
|
|
jerry_size_t jerry_string_substr (const jerry_value_t value, jerry_length_t start, jerry_length_t end);
|
|
jerry_size_t jerry_string_to_buffer (const jerry_value_t value,
|
|
jerry_encoding_t encoding,
|
|
jerry_char_t *buffer_p,
|
|
jerry_size_t buffer_size);
|
|
void jerry_string_iterate (const jerry_value_t value,
|
|
jerry_encoding_t encoding,
|
|
jerry_string_iterate_cb_t callback,
|
|
void *user_p);
|
|
/**
|
|
* jerry-api-string-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-string-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_string_external_on_free (jerry_external_string_free_cb_t callback);
|
|
/**
|
|
* jerry-api-string-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-string @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-symbol Symbol
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-symbol-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_symbol (jerry_well_known_symbol_t symbol);
|
|
jerry_value_t jerry_symbol_with_description (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-symbol-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-symbol-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_symbol_description (const jerry_value_t symbol);
|
|
jerry_value_t jerry_symbol_descriptive_string (const jerry_value_t symbol);
|
|
/**
|
|
* jerry-api-symbol-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-symbol @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-primitives @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-objects Objects
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_object (void);
|
|
/**
|
|
* jerry-api-object-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-get Getters
|
|
* @{
|
|
*/
|
|
|
|
jerry_object_type_t jerry_object_type (const jerry_value_t object);
|
|
jerry_value_t jerry_object_proto (const jerry_value_t object);
|
|
jerry_value_t jerry_object_keys (const jerry_value_t object);
|
|
jerry_value_t jerry_object_property_names (const jerry_value_t object, jerry_property_filter_t filter);
|
|
|
|
/**
|
|
* jerry-api-object-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-op Operations
|
|
* @{
|
|
*/
|
|
|
|
jerry_value_t jerry_object_set_proto (jerry_value_t object, const jerry_value_t proto);
|
|
bool jerry_object_foreach (const jerry_value_t object, jerry_object_property_foreach_cb_t foreach_p, void *user_data_p);
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-op-set Set
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_object_set (jerry_value_t object, const jerry_value_t key, const jerry_value_t value);
|
|
jerry_value_t jerry_object_set_sz (jerry_value_t object, const char *key_p, const jerry_value_t value);
|
|
jerry_value_t jerry_object_set_index (jerry_value_t object, uint32_t index, const jerry_value_t value);
|
|
jerry_value_t jerry_object_define_own_prop (jerry_value_t object,
|
|
const jerry_value_t key,
|
|
const jerry_property_descriptor_t *prop_desc_p);
|
|
bool jerry_object_set_internal (jerry_value_t object, const jerry_value_t key, const jerry_value_t value);
|
|
void jerry_object_set_native_ptr (jerry_value_t object,
|
|
const jerry_object_native_info_t *native_info_p,
|
|
void *native_pointer_p);
|
|
/**
|
|
* jerry-api-object-op-set @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-op-has Has
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_object_has (const jerry_value_t object, const jerry_value_t key);
|
|
jerry_value_t jerry_object_has_sz (const jerry_value_t object, const char *key_p);
|
|
jerry_value_t jerry_object_has_own (const jerry_value_t object, const jerry_value_t key);
|
|
bool jerry_object_has_internal (const jerry_value_t object, const jerry_value_t key);
|
|
bool jerry_object_has_native_ptr (const jerry_value_t object, const jerry_object_native_info_t *native_info_p);
|
|
/**
|
|
* jerry-api-object-op-has @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-op-get Get
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_object_get (const jerry_value_t object, const jerry_value_t key);
|
|
jerry_value_t jerry_object_get_sz (const jerry_value_t object, const char *key_p);
|
|
jerry_value_t jerry_object_get_index (const jerry_value_t object, uint32_t index);
|
|
jerry_value_t jerry_object_get_own_prop (const jerry_value_t object,
|
|
const jerry_value_t key,
|
|
jerry_property_descriptor_t *prop_desc_p);
|
|
jerry_value_t jerry_object_get_internal (const jerry_value_t object, const jerry_value_t key);
|
|
void *jerry_object_get_native_ptr (const jerry_value_t object, const jerry_object_native_info_t *native_info_p);
|
|
|
|
jerry_value_t jerry_object_find_own (const jerry_value_t object,
|
|
const jerry_value_t key,
|
|
const jerry_value_t receiver,
|
|
bool *found_p);
|
|
/**
|
|
* jerry-api-object-op-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-op-del Delete
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_object_delete (jerry_value_t object, const jerry_value_t key);
|
|
jerry_value_t jerry_object_delete_sz (const jerry_value_t object, const char *key_p);
|
|
jerry_value_t jerry_object_delete_index (jerry_value_t object, uint32_t index);
|
|
bool jerry_object_delete_internal (jerry_value_t object, const jerry_value_t key);
|
|
bool jerry_object_delete_native_ptr (jerry_value_t object, const jerry_object_native_info_t *native_info_p);
|
|
/**
|
|
* jerry-api-object-op-del @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-object-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-prop-desc Property descriptors
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-prop-desc-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_property_descriptor_t jerry_property_descriptor (void);
|
|
jerry_value_t jerry_property_descriptor_from_object (const jerry_value_t obj_value,
|
|
jerry_property_descriptor_t *out_prop_desc_p);
|
|
/**
|
|
* jerry-api-object-prop-desc-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-prop-desc-op Operations
|
|
* @{
|
|
*/
|
|
void jerry_property_descriptor_free (jerry_property_descriptor_t *prop_desc_p);
|
|
jerry_value_t jerry_property_descriptor_to_object (const jerry_property_descriptor_t *src_prop_desc_p);
|
|
/**
|
|
* jerry-api-object-prop-desc-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-object-prop-desc @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-native-ptr Native pointers
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-object-native-ptr-op Operations
|
|
* @{
|
|
*/
|
|
void jerry_native_ptr_init (void *native_pointer_p, const jerry_object_native_info_t *native_info_p);
|
|
void jerry_native_ptr_free (void *native_pointer_p, const jerry_object_native_info_t *native_info_p);
|
|
void jerry_native_ptr_set (jerry_value_t *reference_p, const jerry_value_t value);
|
|
/**
|
|
* jerry-api-object-native-ptr-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-object-native-ptr @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-array Array
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-array-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_array (jerry_length_t length);
|
|
/**
|
|
* jerry-api-array-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-array-get Getters
|
|
* @{
|
|
*/
|
|
jerry_length_t jerry_array_length (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-array-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-array @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-arraybuffer ArrayBuffer
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-arraybuffer-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_arraybuffer (const jerry_length_t size);
|
|
jerry_value_t jerry_arraybuffer_external (uint8_t *buffer_p, jerry_length_t size, void *user_p);
|
|
/**
|
|
* jerry-api-arraybuffer-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-arraybuffer-get Getters
|
|
* @{
|
|
*/
|
|
jerry_size_t jerry_arraybuffer_size (const jerry_value_t value);
|
|
uint8_t *jerry_arraybuffer_data (const jerry_value_t value);
|
|
bool jerry_arraybuffer_is_detachable (const jerry_value_t value);
|
|
bool jerry_arraybuffer_has_buffer (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-arraybuffer-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-arraybuffer-op Operations
|
|
* @{
|
|
*/
|
|
jerry_size_t
|
|
jerry_arraybuffer_read (const jerry_value_t value, jerry_size_t offset, uint8_t *buffer_p, jerry_size_t buffer_size);
|
|
jerry_size_t
|
|
jerry_arraybuffer_write (jerry_value_t value, jerry_size_t offset, const uint8_t *buffer_p, jerry_size_t buffer_size);
|
|
jerry_value_t jerry_arraybuffer_detach (jerry_value_t value);
|
|
void jerry_arraybuffer_heap_allocation_limit (jerry_size_t limit);
|
|
/**
|
|
* jerry-api-arraybuffer-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-arraybuffer-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_arraybuffer_allocator (jerry_arraybuffer_allocate_cb_t allocate_callback,
|
|
jerry_arraybuffer_free_cb_t free_callback,
|
|
void *user_p);
|
|
/**
|
|
* jerry-api-arraybuffer-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-arraybuffer @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-sharedarraybuffer SharedArrayBuffer
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-sharedarraybuffer-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_shared_arraybuffer (jerry_size_t size);
|
|
jerry_value_t jerry_shared_arraybuffer_external (uint8_t *buffer_p, jerry_size_t buffer_size, void *user_p);
|
|
/**
|
|
* jerry-api-sharedarraybuffer-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-sharedarraybuffer @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-dataview DataView
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-dataview-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_dataview (const jerry_value_t value, jerry_size_t byte_offset, jerry_size_t byte_length);
|
|
/**
|
|
* jerry-api-dataview-ctr @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-dataview-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t
|
|
jerry_dataview_buffer (const jerry_value_t dataview, jerry_size_t *byte_offset, jerry_size_t *byte_length);
|
|
/**
|
|
* jerry-api-dataview-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-dataview @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-typedarray TypedArray
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-typedarray-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_typedarray (jerry_typedarray_type_t type, jerry_length_t length);
|
|
jerry_value_t jerry_typedarray_with_buffer (jerry_typedarray_type_t type, const jerry_value_t arraybuffer);
|
|
jerry_value_t jerry_typedarray_with_buffer_span (jerry_typedarray_type_t type,
|
|
const jerry_value_t arraybuffer,
|
|
jerry_size_t byte_offset,
|
|
jerry_size_t byte_length);
|
|
/**
|
|
* jerry-api-typedarray-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-typedarray-get Getters
|
|
* @{
|
|
*/
|
|
jerry_typedarray_type_t jerry_typedarray_type (const jerry_value_t value);
|
|
jerry_length_t jerry_typedarray_length (const jerry_value_t value);
|
|
jerry_value_t jerry_typedarray_buffer (const jerry_value_t value, jerry_size_t *byte_offset, jerry_size_t *byte_length);
|
|
/**
|
|
* jerry-api-typedarray-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-typedarray @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-iterator Iterator
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-iterator-get Getters
|
|
* @{
|
|
*/
|
|
jerry_iterator_type_t jerry_iterator_type (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-iterator-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-iterator @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-function Function
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-function-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_function_external (jerry_external_handler_t handler);
|
|
/**
|
|
* jerry-api-function-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-function-get Getters
|
|
* @{
|
|
*/
|
|
jerry_function_type_t jerry_function_type (const jerry_value_t value);
|
|
bool jerry_function_is_dynamic (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-function-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-function-op Operations
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_call (const jerry_value_t function,
|
|
const jerry_value_t this_value,
|
|
const jerry_value_t *args_p,
|
|
jerry_size_t args_count);
|
|
jerry_value_t jerry_construct (const jerry_value_t function, const jerry_value_t *args_p, jerry_size_t args_count);
|
|
/**
|
|
* jerry-api-function-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-function @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-proxy Proxy
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-proxy-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_proxy (const jerry_value_t target, const jerry_value_t handler);
|
|
jerry_value_t jerry_proxy_custom (const jerry_value_t target, const jerry_value_t handler, uint32_t flags);
|
|
/**
|
|
* jerry-api-function-proxy-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-proxy-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_proxy_target (const jerry_value_t value);
|
|
jerry_value_t jerry_proxy_handler (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-function-proxy-get @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-proxy @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-promise Promise
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-promise-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_promise (void);
|
|
/**
|
|
* jerry-api-promise-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-promise-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_promise_result (const jerry_value_t promise);
|
|
jerry_promise_state_t jerry_promise_state (const jerry_value_t promise);
|
|
/**
|
|
* jerry-api-promise-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-promise-op Operations
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_promise_resolve (jerry_value_t promise, const jerry_value_t argument);
|
|
jerry_value_t jerry_promise_reject (jerry_value_t promise, const jerry_value_t argument);
|
|
/**
|
|
* jerry-api-promise-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-promise-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_promise_on_event (jerry_promise_event_filter_t filters, jerry_promise_event_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-promise-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-promise @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-container Map, Set, WeakMap, WeakSet
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-container-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_container (jerry_container_type_t container_type,
|
|
const jerry_value_t *arguments_p,
|
|
jerry_length_t argument_count);
|
|
/**
|
|
* jerry-api-promise-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-container-get Getters
|
|
* @{
|
|
*/
|
|
jerry_container_type_t jerry_container_type (const jerry_value_t value);
|
|
/**
|
|
* jerry-api-container-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-container-op Operations
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_container_to_array (const jerry_value_t value, bool *is_key_value_p);
|
|
jerry_value_t jerry_container_op (jerry_container_op_t operation,
|
|
jerry_value_t container,
|
|
const jerry_value_t *arguments,
|
|
uint32_t argument_count);
|
|
/**
|
|
* jerry-api-container-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-container @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-regexp RegExp
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-regexp-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_regexp (const jerry_value_t pattern, uint16_t flags);
|
|
jerry_value_t jerry_regexp_sz (const char *pattern_p, uint16_t flags);
|
|
/**
|
|
* jerry-api-regexp-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-regexp @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-error Error
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-error-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_error (jerry_error_t type, const jerry_value_t message);
|
|
jerry_value_t jerry_error_sz (jerry_error_t type, const char *message_p);
|
|
/**
|
|
* jerry-api-error-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-error-get Getters
|
|
* @{
|
|
*/
|
|
jerry_error_t jerry_error_type (jerry_value_t value);
|
|
/**
|
|
* jerry-api-error-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-error-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_error_on_created (jerry_error_object_created_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-error-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-error @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-objects @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-json JSON
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-json-op Operations
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_json_parse (const jerry_char_t *string_p, jerry_size_t string_size);
|
|
jerry_value_t jerry_json_stringify (const jerry_value_t object);
|
|
/**
|
|
* jerry-api-json-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-json @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-module Modules
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-module-get Getters
|
|
* @{
|
|
*/
|
|
jerry_module_state_t jerry_module_state (const jerry_value_t module);
|
|
size_t jerry_module_request_count (const jerry_value_t module);
|
|
jerry_value_t jerry_module_request (const jerry_value_t module, size_t request_index);
|
|
jerry_value_t jerry_module_namespace (const jerry_value_t module);
|
|
/**
|
|
* jerry-api-module-get @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-module-op Operations
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Resolve and parse a module file
|
|
*
|
|
* @param specifier: module request specifier string.
|
|
* @param referrer: parent module.
|
|
* @param user_p: user specified pointer.
|
|
*
|
|
* @return module object if resolving is successful, error otherwise.
|
|
*/
|
|
jerry_value_t jerry_module_resolve (const jerry_value_t specifier, const jerry_value_t referrer, void *user_p);
|
|
|
|
jerry_value_t jerry_module_link (const jerry_value_t module, jerry_module_resolve_cb_t callback, void *user_p);
|
|
jerry_value_t jerry_module_evaluate (const jerry_value_t module);
|
|
|
|
/**
|
|
* Release known modules in the current context. If realm parameter is supplied, cleans up modules native to that realm
|
|
* only. This function should be called by the user application when the module database in the current context is no
|
|
* longer needed.
|
|
*
|
|
* @param realm: release only those modules which realm value is equal to this argument.
|
|
*/
|
|
void jerry_module_cleanup (const jerry_value_t realm);
|
|
|
|
/**
|
|
* jerry-api-module-op @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-module-native Native modules
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_native_module (jerry_native_module_evaluate_cb_t callback,
|
|
const jerry_value_t *const exports_p,
|
|
size_t export_count);
|
|
jerry_value_t jerry_native_module_get (const jerry_value_t native_module, const jerry_value_t export_name);
|
|
jerry_value_t
|
|
jerry_native_module_set (jerry_value_t native_module, const jerry_value_t export_name, const jerry_value_t value);
|
|
/**
|
|
* jerry-api-module-native @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-module-cb Callbacks
|
|
* @{
|
|
*/
|
|
void jerry_module_on_state_changed (jerry_module_state_changed_cb_t callback, void *user_p);
|
|
void jerry_module_on_import_meta (jerry_module_import_meta_cb_t callback, void *user_p);
|
|
void jerry_module_on_import (jerry_module_import_cb_t callback, void *user_p);
|
|
/**
|
|
* jerry-api-module-cb @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-module @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-realm Realms
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-realm-ctor Constructors
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_realm (void);
|
|
/**
|
|
* jerry-api-realm-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-realm-get Getters
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_realm_this (jerry_value_t realm);
|
|
/**
|
|
* jerry-api-realm-ctor @}
|
|
*/
|
|
|
|
/**
|
|
* @defgroup jerry-api-realm-op Operation
|
|
* @{
|
|
*/
|
|
jerry_value_t jerry_realm_set_this (jerry_value_t realm, jerry_value_t this_value);
|
|
/**
|
|
* jerry-api-realm-op @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api-realm @}
|
|
*/
|
|
|
|
/**
|
|
* jerry-api @}
|
|
*/
|
|
|
|
JERRY_C_API_END
|
|
|
|
#endif /* !JERRYSCRIPT_CORE_H */
|
|
|
|
/* vim: set fdm=marker fmr=@{,@}: */
|