# QuickJS C/JS 交互示例

本项目演示了 C 和 JavaScript 之间的各种交互方式。

## 编译

```powershell
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
```

## 运行示例

### 简单示例 (simple_demo)

```powershell
.\build\bin\Release\simple_demo.exe
```

简单示例包含：
- 基本的 JavaScript 表达式求值
- 字符串操作
- JavaScript 函数调用
- 从 JavaScript 调用 C 函数

### 完整示例 (demo)

```powershell
.\build\bin\Release\demo.exe
```

完整示例包含：
1. **基本 JavaScript 执行** - 执行简单的 JS 表达式和函数
2. **从 C 调用 JavaScript 函数** - 调用 JS 函数并处理返回值
3. **从 JavaScript 调用 C 函数** - 注册 C 函数供 JS 调用
4. **数据类型转换** - 在 C 和 JS 之间转换各种数据类型
5. **对象操作** - 创建和操作 JavaScript 对象
6. **数组操作** - 创建和操作 JavaScript 数组
7. **异常处理** - 处理 JS 和 C 中的异常
8. **内存管理** - JSValue 的引用计数和垃圾回收
9. **标准库模块** - 使用 std 和 os 模块
10. **自定义模块** - 创建和使用自定义 JS 模块

## 关键 API

### 初始化
```c
JSRuntime *rt = JS_NewRuntime();
JSContext *ctx = JS_NewContext(rt);
js_std_add_helpers(ctx, argc, argv);
```

### 执行 JavaScript
```c
JSValue result = JS_Eval(ctx, "1 + 2", 5, "<eval>", JS_EVAL_TYPE_GLOBAL);
```

### 注册 C 函数
```c
JSValue func = JS_NewCFunction(ctx, my_c_function, "funcName", argCount);
JS_SetPropertyStr(ctx, global, "funcName", func);
```

### 数据类型转换
```c
// C 到 JS
JSValue val = JS_NewInt32(ctx, 42);
JSValue str = JS_NewString(ctx, "Hello");

// JS 到 C
double num;
JS_ToFloat64(ctx, &num, js_value);
const char *str = JS_ToCString(ctx, js_value);
JS_FreeCString(ctx, str);
```

### 内存管理
```c
JSValue val = JS_NewString(ctx, "test");
JSValue val2 = JS_DupValue(ctx, val);  // 增加引用
JS_FreeValue(ctx, val);    // 释放引用
JS_FreeValue(ctx, val2);   // 最后一个引用被释放
```

### 异常处理
```c
JSValue exception = JS_GetException(ctx);
if (!JS_IsUndefined(exception)) {
    // 处理异常
}
JS_FreeValue(ctx, exception);
```

## 项目结构

```
quickjs-prj/
├── yps-quickjs/          # QuickJS 库源码
│   ├── quickjs.c/h       # 核心 API
│   ├── quickjs-libc.c/h  # 标准库扩展
│   └── CMakeLists.txt    # 库构建配置
├── main.c                # 完整示例
├── simple_demo.c         # 简单示例
├── CMakeLists.txt        # 主项目构建配置
└── build/                # 构建输出目录
    ├── lib/              # 静态库
    └── bin/              # 可执行文件
```

## 集成到你的项目

在你的 CMakeLists.txt 中添加：

```cmake
add_subdirectory(path/to/yps-quickjs)
target_link_libraries(your_target PRIVATE ypqjs)
target_include_directories(your_target PRIVATE path/to/yps-quickjs)
```

## 注意事项

1. **栈大小**：Windows 上默认需要 8MB 栈大小
2. **编码**：源文件使用 UTF-8 编码以支持中文字符
3. **内存管理**：及时释放 JSValue 以避免内存泄漏
4. **异常处理**：执行 JS 代码后检查异常
5. **线程安全**：每个线程需要独立的 JSRuntime 和 JSContext