mirror of
https://github.com/zebrajr/node.git
synced 2026-01-15 12:15:26 +00:00
60d9aed307
Introduce APIs that allow for the creation of JavaScript strings without copying the underlying native string into the engine. The APIs fall back to regular string creation if the engine's external string APIs are unavailable. In this case, an optional boolean out-parameter indicates that the string was copied, and the optional finalizer is called if given. PR-URL: https://github.com/nodejs/node/pull/48339 Fixes: https://github.com/nodejs/node/issues/48198 Reviewed-By: Daeyeon Jeong <daeyeon.dev@gmail.com> Signed-off-by: Gabriel Schulhof <gabrielschulhof@gmail.com>
87 lines
4.5 KiB
C
87 lines
4.5 KiB
C
#include <js_native_api.h>
|
|
|
|
// Empty value so that macros here are able to return NULL or void
|
|
#define NODE_API_RETVAL_NOTHING // Intentionally blank #define
|
|
|
|
#define GET_AND_THROW_LAST_ERROR(env) \
|
|
do { \
|
|
const napi_extended_error_info *error_info; \
|
|
napi_get_last_error_info((env), &error_info); \
|
|
bool is_pending; \
|
|
const char* err_message = error_info->error_message; \
|
|
napi_is_exception_pending((env), &is_pending); \
|
|
/* If an exception is already pending, don't rethrow it */ \
|
|
if (!is_pending) { \
|
|
const char* error_message = err_message != NULL ? \
|
|
err_message : \
|
|
"empty error message"; \
|
|
napi_throw_error((env), NULL, error_message); \
|
|
} \
|
|
} while (0)
|
|
|
|
#define NODE_API_ASSERT_BASE(env, assertion, message, ret_val) \
|
|
do { \
|
|
if (!(assertion)) { \
|
|
napi_throw_error( \
|
|
(env), \
|
|
NULL, \
|
|
"assertion (" #assertion ") failed: " message); \
|
|
return ret_val; \
|
|
} \
|
|
} while (0)
|
|
|
|
// Returns NULL on failed assertion.
|
|
// This is meant to be used inside napi_callback methods.
|
|
#define NODE_API_ASSERT(env, assertion, message) \
|
|
NODE_API_ASSERT_BASE(env, assertion, message, NULL)
|
|
|
|
// Returns empty on failed assertion.
|
|
// This is meant to be used inside functions with void return type.
|
|
#define NODE_API_ASSERT_RETURN_VOID(env, assertion, message) \
|
|
NODE_API_ASSERT_BASE(env, assertion, message, NODE_API_RETVAL_NOTHING)
|
|
|
|
#define NODE_API_CALL_BASE(env, the_call, ret_val) \
|
|
do { \
|
|
if ((the_call) != napi_ok) { \
|
|
GET_AND_THROW_LAST_ERROR((env)); \
|
|
return ret_val; \
|
|
} \
|
|
} while (0)
|
|
|
|
// Returns NULL if the_call doesn't return napi_ok.
|
|
#define NODE_API_CALL(env, the_call) \
|
|
NODE_API_CALL_BASE(env, the_call, NULL)
|
|
|
|
// Returns empty if the_call doesn't return napi_ok.
|
|
#define NODE_API_CALL_RETURN_VOID(env, the_call) \
|
|
NODE_API_CALL_BASE(env, the_call, NODE_API_RETVAL_NOTHING)
|
|
|
|
#define NODE_API_CHECK_STATUS(the_call) \
|
|
do { \
|
|
napi_status status = (the_call); \
|
|
if (status != napi_ok) { \
|
|
return status; \
|
|
} \
|
|
} while (0)
|
|
|
|
#define NODE_API_ASSERT_STATUS(env, assertion, message) \
|
|
NODE_API_ASSERT_BASE(env, assertion, message, napi_generic_failure)
|
|
|
|
#define DECLARE_NODE_API_PROPERTY(name, func) \
|
|
{ (name), NULL, (func), NULL, NULL, NULL, napi_default, NULL }
|
|
|
|
#define DECLARE_NODE_API_GETTER(name, func) \
|
|
{ (name), NULL, NULL, (func), NULL, NULL, napi_default, NULL }
|
|
|
|
#define DECLARE_NODE_API_PROPERTY_VALUE(name, value) \
|
|
{ (name), NULL, NULL, NULL, NULL, (value), napi_default, NULL }
|
|
|
|
void add_returned_status(napi_env env,
|
|
const char* key,
|
|
napi_value object,
|
|
char* expected_message,
|
|
napi_status expected_status,
|
|
napi_status actual_status);
|
|
|
|
void add_last_status(napi_env env, const char* key, napi_value return_value);
|