txiki.js中FFI回调函数使用的注意事项

在JavaScript与C语言交互的场景中，回调函数是一个非常重要的机制。txiki.js项目通过其FFI（Foreign Function Interface）模块提供了强大的跨语言调用能力，但在使用过程中开发者可能会遇到一些意料之外的行为。

回调函数的基本用法

txiki.js的FFI模块允许JavaScript函数作为回调传递给C代码。标准用法是创建一个JSCallback对象，然后将其传递给C函数。例如：

const cb = new ffi.JSCallback(ffi.types.sint64, [], () => { return 42 });
const fn = new ffi.CFunction(libffi.symbol('testcb'), ffi.types.void, [ffi.types.jscallback]);
fn.call(cb);  // 注意这里直接传递cb而非[cb]

对应的C函数可能如下：

void testcb(long int (*cb)()) {
    long int val = cb();
    printf("Hello %ld\n", val);
}

常见误区与解决方案

开发者容易犯的一个错误是在调用时错误地包装回调参数。txiki.js的FFI模块处理参数时有一些特殊行为：

1. 参数传递方式：直接传递回调对象，而不是将其放入数组中。这与某些其他FFI实现不同。

2. 类型匹配：确保C函数签名与JavaScript中声明的回调类型完全匹配，包括返回类型和参数类型。

3. 显式指针转换：如果确实需要传递回调的地址，可以使用更显式的方式：

const cb = new ffi.JSCallback(ffi.types.sint64, [], () => { return 42 });
const fn = new ffi.CFunction(libffi.symbol('testcb'), ffi.types.void, [ffi.types.pointer]);
fn.call(cb.addr);  // 显式传递回调地址

类型系统注意事项

txiki.js的FFI类型系统有一些值得注意的地方：

• 类型名称可能不完全直观，例如sint64对应C的long int
• 某些类型可能有多个别名，开发者应检查实际类型定义
• 返回类型和参数类型的声明顺序很重要

最佳实践建议

1. 始终检查回调函数的类型签名是否与C端完全匹配
2. 考虑使用显式指针转换方式以提高代码可读性
3. 对于复杂场景，可以先测试简单的回调案例
4. 注意txiki.js特有的参数传递约定

通过理解这些细节，开发者可以更有效地利用txiki.js的FFI功能实现JavaScript与C代码的无缝交互。