1 | /* Copyright JS Foundation and other contributors, http://js.foundation |
2 | * |
3 | * Licensed under the Apache License, Version 2.0 (the "License"); |
4 | * you may not use this file except in compliance with the License. |
5 | * You may obtain a copy of the License at |
6 | * |
7 | * http://www.apache.org/licenses/LICENSE-2.0 |
8 | * |
9 | * Unless required by applicable law or agreed to in writing, software |
10 | * distributed under the License is distributed on an "AS IS" BASIS |
11 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 | * See the License for the specific language governing permissions and |
13 | * limitations under the License. |
14 | */ |
15 | |
16 | #ifndef JERRYX_HANDLER_H |
17 | #define JERRYX_HANDLER_H |
18 | |
19 | #include "jerryscript.h" |
20 | |
21 | #ifdef __cplusplus |
22 | extern "C" |
23 | { |
24 | #endif /* __cplusplus */ |
25 | |
26 | /* |
27 | * Handler registration helper |
28 | */ |
29 | |
30 | jerry_value_t jerryx_handler_register_global (const jerry_char_t *name_p, |
31 | jerry_external_handler_t handler_p); |
32 | |
33 | /* |
34 | * Common external function handlers |
35 | */ |
36 | |
37 | jerry_value_t jerryx_handler_assert_fatal (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
38 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
39 | jerry_value_t jerryx_handler_assert_throw (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
40 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
41 | jerry_value_t jerryx_handler_assert (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
42 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
43 | jerry_value_t jerryx_handler_gc (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
44 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
45 | jerry_value_t jerryx_handler_print (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
46 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
47 | jerry_value_t jerryx_handler_resource_name (const jerry_value_t func_obj_val, const jerry_value_t this_p, |
48 | const jerry_value_t args_p[], const jerry_length_t args_cnt); |
49 | |
50 | /** |
51 | * Struct used by the `jerryx_set_functions` method to |
52 | * register multiple methods for a given object. |
53 | */ |
54 | typedef struct |
55 | { |
56 | const char *name; /**< name of the property to add */ |
57 | jerry_value_t value; /**< value of the property */ |
58 | } jerryx_property_entry; |
59 | |
60 | #define JERRYX_PROPERTY_NUMBER(NAME, NUMBER) (jerryx_property_entry) { NAME, jerry_create_number (NUMBER) } |
61 | #define JERRYX_PROPERTY_STRING(NAME, STR) \ |
62 | (jerryx_property_entry) { NAME, jerry_create_string_from_utf8 ((const jerry_char_t *) STR) } |
63 | #define JERRYX_PROPERTY_STRING_SZ(NAME, STR, SIZE) \ |
64 | (jerryx_property_entry) { NAME, jerry_create_string_sz_from_utf8 ((const jerry_char_t *) STR, SIZE) } |
65 | #define JERRYX_PROPERTY_BOOLEAN(NAME, VALUE) (jerryx_property_entry) { NAME, jerry_create_boolean (VALUE) } |
66 | #define JERRYX_PROPERTY_FUNCTION(NAME, FUNC) (jerryx_property_entry) { NAME, jerry_create_external_function (FUNC) } |
67 | #define JERRYX_PROPERTY_UNDEFINED(NAME) (jerryx_property_entry) { NAME, jerry_create_undefined() } |
68 | #define JERRYX_PROPERTY_LIST_END() (jerryx_property_entry) { NULL, 0 } |
69 | |
70 | /** |
71 | * Stores the result of property register operation. |
72 | */ |
73 | typedef struct |
74 | { |
75 | jerry_value_t result; /**< result of property registraion (undefined or error object) */ |
76 | uint32_t registered; /**< number of successfully registered methods */ |
77 | } jerryx_register_result; |
78 | |
79 | jerryx_register_result |
80 | jerryx_set_properties (const jerry_value_t target_object, |
81 | const jerryx_property_entry entries[]); |
82 | |
83 | void |
84 | jerryx_release_property_entry (const jerryx_property_entry entries[], |
85 | const jerryx_register_result register_result); |
86 | |
87 | jerry_value_t |
88 | jerryx_set_property_str (const jerry_value_t target_object, |
89 | const char *name, |
90 | const jerry_value_t value); |
91 | |
92 | jerry_value_t |
93 | jerryx_get_property_str (const jerry_value_t target_object, |
94 | const char *name); |
95 | |
96 | bool |
97 | jerryx_has_property_str (const jerry_value_t target_object, |
98 | const char *name); |
99 | |
100 | #ifdef __cplusplus |
101 | } |
102 | #endif /* __cplusplus */ |
103 | #endif /* !JERRYX_HANDLER_H */ |
104 | |