OpenPRA Documentation

packages/engine/scram-node/targets/scram-node/src/AsyncRunScramCli.h ​

Functions ​

Name
Napi::ValueAsyncRunScramCli(const Napi::CallbackInfo & info)<br>Main Node.js wrapper function to run the SCRAM CLI asynchronously.

Functions Documentation ​

function AsyncRunScramCli ​

cpp
inline Napi::Value AsyncRunScramCli(
    const Napi::CallbackInfo & info
)

Main Node.js wrapper function to run the SCRAM CLI asynchronously.

Parameters:

  • info The callback info from Node.js, containing the input arguments and callback function.

Return: Napi::Value Returns undefined on successful queuing of the task, or throws a JavaScript exception on error.

Source code ​

cpp
#pragma once

#include "AsyncScramWorker.h"

inline Napi::Value AsyncRunScramCli(const Napi::CallbackInfo &info) {
    Napi::Env env = info.Env();

    // Validate the first argument to ensure it's an object.
    if (!info[0].IsObject()) {
        Napi::TypeError::New(env, "Object expected").ThrowAsJavaScriptException();
        return env.Null();
    }

    // Extract arguments from the input object to pass to the scram command.
    auto input = info[0].As<Napi::Object>();
    std::vector<std::string> arguments;

    // Convert properties of the input object to command-line arguments.
    Napi::Array propertyNames = input.GetPropertyNames();
    Napi::Array xmlArray;
    for (uint32_t i = 0; i < propertyNames.Length(); i++) {
        Napi::Value key = propertyNames.Get(i);
        Napi::Value value = input.Get(key.ToString());
        std::string keyStr = key.ToString().Utf8Value();
        if (keyStr == "models") {
            xmlArray = value.As<Napi::Array>();
        } else {
            arguments.push_back("--" + keyStr);
            if (!value.IsBoolean()) {
                arguments.push_back(value.ToString().Utf8Value());
            }
        }
    };

    // Add XML model files at the end of the arguments.
    for (size_t j = 0; j < xmlArray.Length(); j++) {
        arguments.push_back(xmlArray.Get(j).ToString().Utf8Value());
    };

    // Validate the second argument to ensure it's a callback function.
    if (!info[1].IsFunction()) {
        Napi::TypeError::New(env, "Function expected as second argument").ThrowAsJavaScriptException();
        return env.Null();
    }
    auto callback = info[1].As<Napi::Function>();

    // Create a ScramWorker to run the scram command asynchronously and queue it for execution.
    auto *worker = new AsyncScramWorker(callback, arguments);
    worker->Queue();

    return env.Undefined();
}

Updated on 2025-11-11 at 16:51:09 +0000