node-ffi/node-ffi
Node Ffi
node-ffi 是一个 Node.js 的外部函数接口库，无需编写手动 C++ 绑定即可调用原生 C 动态库中的函数。它作为一个系统，用于将共享对象和 DLL 加载到进程内存中，将 JavaScript 值转换为二进制表示，并在运行时执行外部二进制文件。
该项目利用 libffi 库的包装器来构建调用帧并使用动态参数执行原生函数。它的特色在于提供了一个用于分配原始指针的原生内存管理器，以及一个将复杂 C 结构映射到 JavaScript 对象的映射系统。
该工具包涵盖了广泛的原生互操作性功能，包括自动数据类型转换和创建可执行内存存根，允许原生库触发 JavaScript 回调。为了保持主线程响应能力，它支持异步执行模型，将原生函数调用卸载到单独的线程池中。
Features
- Dynamic Library Function Executions - Provides the core ability to load external shared objects and execute native C functions directly from JavaScript.
- Foreign Function Interfaces - Provides a comprehensive interface and binding layer for seamless communication between JavaScript and native libraries.
- Memory-Mapped Data Structures - Connects complex C data structures to JavaScript objects for efficient reading and writing of structured memory blocks.
- C-to-JavaScript Type Mappings - Provides systems for converting data types specifically between C and JavaScript for memory-compatible function calls.
- C Struct Mappings - Maps complex C structures and memory blocks into JavaScript objects for reading and writing structured memory.
- Dynamic Library Loading - Loads external shared objects or DLLs into the process memory space at runtime via system call interfaces.
- Raw Memory Allocation - Provides a low-level interface for allocating raw contiguous memory buffers and manipulating C-style pointers.
- Foreign Function Interface Calls - Executes functions from shared libraries by mapping JavaScript types to native C equivalents using libffi.
- Function-Pointer Callbacks - Creates executable memory stubs that map JavaScript functions as C-style function pointers for native library callbacks.
- Native C-JavaScript Bridges - Provides an interface designed for data exchange and function calls between native C/C++ code and JavaScript.
- Native Library Wrappers - Wraps the libffi library to construct native call frames and execute functions with dynamic arguments.
- Node.js Foreign Function Interfaces - A library for calling functions from native C dynamic libraries directly within Node.js without writing manual C++ bindings.
- Pointer-Based Memory Access - Implements direct manipulation and extraction of data from raw pointers to handle C structs across the language boundary.
- Native Library Integration - Allows calling functions from external C or C++ dynamic libraries directly within Node.js without manual glue code.
- Dynamic Library Loaders - Loads shared objects and DLLs into process memory to execute external binaries at runtime.
- Native Callbacks - Maps JavaScript functions to C-style function pointers, allowing native libraries to trigger logic within the runtime.
- Asynchronous Native Calls - Offloads native function execution to a separate thread pool to prevent blocking the Node.js main event loop.
- Native Callback Stubs - Creates function pointers in memory that allow native libraries to trigger JavaScript callbacks.
- Worker Thread Patterns - Offloads native function calls to a separate thread pool to prevent blocking the JavaScript main event loop.
