Assert Property

Assert that a Node-API value has a specified property.

Usage

var headerDir = require( '@stdlib/assert/napi/has-property' );

headerDir

Absolute file path for the directory containing header files for C APIs.

var dir = headerDir;
// returns <string>

Examples

var headerDir = require( '@stdlib/assert/napi/has-property' );

console.log( headerDir );
// => <string>

C APIs

Usage

#include "stdlib/assert/napi/has_property.h"

stdlib_assert_napi_value_has_property( env, value, property, message, *err )

Asserts that a Node-API value has a specified property.

#include "stdlib/assert/napi/has_property.h"
#include <node_api.h>

static napi_value addon( napi_env env, napi_callback_info info ) {
    napi_value value;

    // ...

    napi_value err;
    napi_status status = stdlib_assert_napi_value_has_property( env, value, "foo", "Missing property.", &err );
    assert( status == napi_ok );
    if ( err != NULL ) {
        assert( napi_throw( env, err ) == napi_ok );
        return NULL;
    }

    // ...
}

The function accepts the following arguments:

env: [in] napi_env environment under which the function is invoked.
value: [in] napi_value Node-API value.
property: [in] char* property name.
message: [in] char* error message.
err: [out] napi_value* pointer for storing a JavaScript error.

napi_status stdlib_assert_napi_value_has_property( const napi_env env, const napi_value value, const char *property, const char *message, napi_value *err );

The function returns a napi_status status code indicating success or failure (returns napi_ok if success).

Notes

If not provided a typed array, the function sets err with a JavaScript error; otherwise, err is set to NULL.