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#include "jerryscript-ext/handler.h"
17
18/**
19 * Register a JavaScript function in the global object.
20 *
21 * Note:
22 * returned value must be freed with jerry_release_value, when it is no longer needed.
23 *
24 * @return true value - if the operation was successful,
25 * error - otherwise.
26 */
27jerry_value_t
28jerryx_handler_register_global (const jerry_char_t *name_p, /**< name of the function */
29 jerry_external_handler_t handler_p) /**< function callback */
30{
31 jerry_value_t global_obj_val = jerry_get_global_object ();
32 jerry_value_t function_name_val = jerry_create_string (name_p);
33 jerry_value_t function_val = jerry_create_external_function (handler_p);
34
35 jerry_value_t result_val = jerry_set_property (global_obj_val, function_name_val, function_val);
36
37 jerry_release_value (function_val);
38 jerry_release_value (function_name_val);
39 jerry_release_value (global_obj_val);
40
41 return result_val;
42} /* jerryx_handler_register_global */
43
44/**
45 * Set multiple properties on a target object.
46 *
47 * The properties are an array of (name, property value) pairs and
48 * this list must end with a (NULL, 0) entry.
49 *
50 * Notes:
51 * - Each property value in the input array is released after a successful property registration.
52 * - The property name must be a zero terminated UTF-8 string.
53 * - There should be no '\0' (NULL) character in the name excluding the string terminator.
54 * - The method `jerryx_release_property_entry` must be called if there is any failed registration
55 * to release the values in the entries array.
56 *
57 * @return `jerryx_register_result` struct - if everything is ok with the (undefined, property entry count) values.
58 * In case of error the (error object, registered property count) pair.
59 */
60jerryx_register_result
61jerryx_set_properties (const jerry_value_t target_object, /**< target object */
62 const jerryx_property_entry entries[]) /**< array of method entries */
63{
64#define JERRYX_SET_PROPERTIES_RESULT(VALUE, IDX) ((jerryx_register_result) { VALUE, IDX })
65 uint32_t idx = 0;
66
67 if (entries == NULL)
68 {
69 return JERRYX_SET_PROPERTIES_RESULT (jerry_create_undefined (), 0);
70 }
71
72 for (; (entries[idx].name != NULL); idx++)
73 {
74 const jerryx_property_entry *entry = &entries[idx];
75
76 jerry_value_t prop_name = jerry_create_string_from_utf8 ((const jerry_char_t *) entry->name);
77 jerry_value_t result = jerry_set_property (target_object, prop_name, entry->value);
78
79 jerry_release_value (prop_name);
80
81 // By API definition:
82 // The jerry_set_property returns TRUE if there is no problem
83 // and error object if there is any problem.
84 // Thus there is no need to check if the boolean value is false or not.
85 if (!jerry_value_is_boolean (result))
86 {
87 return JERRYX_SET_PROPERTIES_RESULT (result, idx);
88 }
89
90 jerry_release_value (entry->value);
91 jerry_release_value (result);
92 }
93
94 return JERRYX_SET_PROPERTIES_RESULT (jerry_create_undefined (), idx);
95#undef JERRYX_SET_PROPERTIES_RESULT
96} /* jerryx_set_properties */
97
98/**
99 * Release all jerry_value_t in a jerryx_property_entry array based on
100 * a previous jerryx_set_properties call.
101 *
102 * In case of a successful registration it is safe to call this method.
103 */
104void
105jerryx_release_property_entry (const jerryx_property_entry entries[], /**< list of property entries */
106 const jerryx_register_result register_result) /**< previous result of registration */
107{
108 if (entries == NULL)
109 {
110 return;
111 }
112
113 for (uint32_t idx = register_result.registered; entries[idx].name != NULL; idx++)
114 {
115 jerry_release_value (entries[idx].value);
116 }
117} /* jerryx_release_property_entry */
118
119/**
120 * Set a property to a specified value with a given name.
121 *
122 * Notes:
123 * - The operation performed is the same as what the `jerry_set_property` method.
124 * - The property name must be a zero terminated UTF-8 string.
125 * - There should be no '\0' (NULL) character in the name excluding the string terminator.
126 * - Returned value must be freed with jerry_release_value, when it is no longer needed.
127 *
128 * @return true value - if the operation was successful
129 * thrown error - otherwise
130 */
131jerry_value_t
132jerryx_set_property_str (const jerry_value_t target_object, /**< target object */
133 const char *name, /**< property name */
134 const jerry_value_t value) /**< value to set */
135{
136 jerry_value_t property_name_val = jerry_create_string_from_utf8 ((const jerry_char_t *) name);
137 jerry_value_t result_val = jerry_set_property (target_object, property_name_val, value);
138
139 jerry_release_value (property_name_val);
140
141 return result_val;
142} /* jerryx_set_property_str */
143
144/**
145 * Get a property value of a specified object.
146 *
147 * Notes:
148 * - The operation performed is the same as what the `jerry_get_property` method.
149 * - The property name must be a zero terminated UTF-8 string.
150 * - There should be no '\0' (NULL) character in the name excluding the string terminator.
151 * - Returned value must be freed with jerry_release_value, when it is no longer needed.
152 *
153 * @return jerry_value_t - the property value
154 */
155jerry_value_t
156jerryx_get_property_str (const jerry_value_t target_object, /**< target object */
157 const char *name) /**< property name */
158{
159 jerry_value_t prop_name = jerry_create_string_from_utf8 ((const jerry_char_t *) name);
160 jerry_value_t result_val = jerry_get_property (target_object, prop_name);
161 jerry_release_value (prop_name);
162
163 return result_val;
164} /* jerryx_get_property_str */
165
166/**
167 * Check if a property exists on an object.
168 *
169 * Notes:
170 * - The operation performed is the same as what the `jerry_has_property` method.
171 * - The property name must be a zero terminated UTF-8 string.
172 * - There should be no '\0' (NULL) character in the name excluding the string terminator.
173 *
174 * @return true - if the property exists on the given object.
175 * false - if there is no such property or there was an error accessing the property.
176 */
177bool
178jerryx_has_property_str (const jerry_value_t target_object, /**< target object */
179 const char *name) /**< property name */
180{
181 bool has_property = false;
182
183 jerry_value_t prop_name = jerry_create_string_from_utf8 ((const jerry_char_t *) name);
184 jerry_value_t has_prop_val = jerry_has_property (target_object, prop_name);
185
186 if (!jerry_value_is_error (has_prop_val))
187 {
188 has_property = jerry_get_boolean_value (has_prop_val);
189 }
190
191 jerry_release_value (has_prop_val);
192 jerry_release_value (prop_name);
193
194 return has_property;
195} /* jerryx_has_property_str */
196