mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
90efdf9c8b
It provides some APIs for binding developers, so that they can validate the type of the js argument and convert/assign them to the native argument. Related Issue: #1716 JerryScript-DCO-1.0-Signed-off-by: Martijn The martijn.the@intel.com JerryScript-DCO-1.0-Signed-off-by: Zidong Jiang zidong.jiang@intel.com
89 lines
3.1 KiB
C
89 lines
3.1 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.
|
|
*/
|
|
|
|
#include "arg-internal.h"
|
|
#include "jerryscript-ext/arg.h"
|
|
#include "jerryscript.h"
|
|
|
|
/**
|
|
* Validate the JS arguments and assign them to the native arguments.
|
|
*
|
|
* @return jerry undefined: all validators passed,
|
|
* jerry error: a validator failed.
|
|
*/
|
|
jerry_value_t
|
|
jerryx_arg_transform_args (const jerry_value_t *js_arg_p, /**< points to the array with JS arguments */
|
|
const jerry_length_t js_arg_cnt, /**< the count of the `js_arg_p` array */
|
|
const jerryx_arg_t *c_arg_p, /**< points to the array of validation/transformation steps */
|
|
jerry_length_t c_arg_cnt) /**< the count of the `c_arg_p` array */
|
|
{
|
|
jerry_value_t ret = jerry_create_undefined ();
|
|
|
|
jerryx_arg_js_iterator_t iterator =
|
|
{
|
|
.js_arg_p = js_arg_p,
|
|
.js_arg_cnt = js_arg_cnt,
|
|
.js_arg_idx = 0
|
|
};
|
|
|
|
for (; c_arg_cnt != 0 && !jerry_value_has_error_flag (ret); c_arg_cnt--, c_arg_p++)
|
|
{
|
|
ret = c_arg_p->func (&iterator, c_arg_p);
|
|
}
|
|
|
|
return ret;
|
|
} /* jerryx_arg_transform_args */
|
|
|
|
/**
|
|
* Validate the this value and the JS arguments,
|
|
* and assign them to the native arguments.
|
|
* This function is useful to perform input validation inside external
|
|
* function handlers (see jerry_external_handler_t).
|
|
* @note this_val is processed as the first value, before the array of arguments.
|
|
*
|
|
* @return jerry undefined: all validators passed,
|
|
* jerry error: a validator failed.
|
|
*/
|
|
jerry_value_t
|
|
jerryx_arg_transform_this_and_args (const jerry_value_t this_val, /**< the this_val for the external function */
|
|
const jerry_value_t *js_arg_p, /**< points to the array with JS arguments */
|
|
const jerry_length_t js_arg_cnt, /**< the count of the `js_arg_p` array */
|
|
const jerryx_arg_t *c_arg_p, /**< points to the array of transformation steps */
|
|
jerry_length_t c_arg_cnt) /**< the count of the `c_arg_p` array */
|
|
{
|
|
if (c_arg_cnt == 0)
|
|
{
|
|
return jerry_create_undefined ();
|
|
}
|
|
|
|
jerryx_arg_js_iterator_t iterator =
|
|
{
|
|
.js_arg_p = &this_val,
|
|
.js_arg_cnt = 1,
|
|
.js_arg_idx = 0
|
|
};
|
|
|
|
jerry_value_t ret = c_arg_p->func (&iterator, c_arg_p);
|
|
|
|
if (jerry_value_has_error_flag (ret))
|
|
{
|
|
jerry_release_value (ret);
|
|
|
|
return jerry_create_error (JERRY_ERROR_TYPE, (jerry_char_t *) "'this' validation failed");
|
|
}
|
|
|
|
return jerryx_arg_transform_args (js_arg_p, js_arg_cnt, c_arg_p + 1, c_arg_cnt - 1);
|
|
} /* jerryx_arg_transform_this_and_args */
|