mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
216dc251ec
This API is obsolete and can be fully replaced with existing `api.h`. JerryScript-DCO-1.0-Signed-off-by: Evgeny Gavrin e.gavrin@samsung.com
120 lines
3.4 KiB
C
120 lines
3.4 KiB
C
/* Copyright 2015 Samsung Electronics Co., Ltd.
|
|
*
|
|
* 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 JERRY_H
|
|
#define JERRY_H
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#include "jerry-api.h"
|
|
|
|
/** \addtogroup jerry Jerry engine interface
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Jerry flags
|
|
*/
|
|
typedef uint32_t jerry_flag_t;
|
|
|
|
#define JERRY_FLAG_EMPTY (0u) /**< empty flag set */
|
|
#define JERRY_FLAG_SHOW_OPCODES (1u << 0) /**< dump opcodes to stdout after parse */
|
|
#define JERRY_FLAG_MEM_STATS (1u << 1) /**< dump memory statistics */
|
|
#define JERRY_FLAG_MEM_STATS_PER_OPCODE (1u << 2) /**< dump per-opcode memory statistics during execution
|
|
* (in the mode full GC is performed after each opcode handler) */
|
|
#define JERRY_FLAG_MEM_STATS_SEPARATE (1u << 3) /**< dump memory statistics and reset peak values after parse */
|
|
#define JERRY_FLAG_PARSE_ONLY (1u << 4) /**< parse only, prevents script execution (only for testing)
|
|
* FIXME: Remove. */
|
|
#define JERRY_FLAG_ENABLE_LOG (1u << 5) /**< enable logging */
|
|
#define JERRY_FLAG_ABORT_ON_FAIL (1u << 6) /**< abort instead of exit in case of failure */
|
|
|
|
/**
|
|
* Error codes
|
|
*/
|
|
typedef enum
|
|
{
|
|
ERR_OUT_OF_MEMORY = 10,
|
|
ERR_SYSCALL = 11,
|
|
ERR_UNIMPLEMENTED_CASE = 118,
|
|
ERR_FAILED_INTERNAL_ASSERTION = 120
|
|
} jerry_fatal_code_t;
|
|
|
|
/**
|
|
* Jerry engine build date
|
|
*/
|
|
extern const char *jerry_build_date;
|
|
|
|
/**
|
|
* Jerry engine build commit hash
|
|
*/
|
|
extern const char *jerry_commit_hash;
|
|
|
|
/**
|
|
* Jerry engine build branch name
|
|
*/
|
|
extern const char *jerry_branch_name;
|
|
|
|
#ifdef JERRY_ENABLE_LOG
|
|
extern int jerry_debug_level;
|
|
extern FILE *jerry_log_file;
|
|
#endif /* JERRY_ENABLE_LOG */
|
|
|
|
/**
|
|
* Jerry error callback type
|
|
*/
|
|
typedef void (*jerry_error_callback_t) (jerry_fatal_code_t);
|
|
|
|
extern EXTERN_C void jerry_init (jerry_flag_t flags);
|
|
extern EXTERN_C void jerry_cleanup (void);
|
|
|
|
extern EXTERN_C void jerry_get_memory_limits (size_t *out_data_bss_brk_limit_p, size_t *out_stack_limit_p);
|
|
extern EXTERN_C void jerry_reg_err_callback (jerry_error_callback_t callback);
|
|
|
|
extern EXTERN_C bool jerry_parse (const char* source_p, size_t source_size);
|
|
extern EXTERN_C jerry_completion_code_t jerry_run (void);
|
|
|
|
extern EXTERN_C jerry_completion_code_t
|
|
jerry_run_simple (const char *script_source,
|
|
size_t script_source_size,
|
|
jerry_flag_t flags);
|
|
|
|
#ifdef CONFIG_JERRY_ENABLE_CONTEXTS
|
|
/** \addtogroup jerry Jerry run contexts-related interface
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Jerry run context descriptor
|
|
*/
|
|
typedef struct jerry_ctx_t jerry_ctx_t;
|
|
|
|
extern EXTERN_C jerry_ctx_t* jerry_new_ctx (void);
|
|
extern EXTERN_C void jerry_cleanup_ctx (jerry_ctx_t* ctx_p);
|
|
|
|
extern EXTERN_C void jerry_push_ctx (jerry_ctx_t *ctx_p);
|
|
extern EXTERN_C void jerry_pop_ctx (void);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
#endif /* CONFIG_JERRY_ENABLE_CONTEXTS */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* !JERRY_H */
|