KossJS 使用示例

基础示例

1. 基本计算

from kossjs_interface import KossJS

with KossJS() as koss:
    result = koss.eval("1 + 2")
    print(f"1 + 2 = {result}")  # 输出: 3

2. 函数定义

from kossjs_interface import KossJS

with KossJS() as koss:
    code = """
    const add = (a, b) => a + b;
    add(5, 10);
    """
    result = koss.eval(code)
    print(f"Result: {result}")  # 输出: 15

3. 异步 Fetch

from kossjs_interface import KossJS

with KossJS() as koss:
    result = koss.run_async("""
    (async () => {
      const res = await fetch("https://jsonplaceholder.typicode.com/todos/1");
      const data = await res.json();
      return data.title;
    })();
    """, timeout_ms=10000)
    print(result)

4. 设置全局变量

from kossjs_interface import KossJS

with KossJS() as koss:
    koss.set_global("APPNAME", "MyApp")
    koss.set_global("VERSION", 1.0)
    
    result = koss.eval("APPNAME + ' v' + VERSION")
    print(f"App info: {result}")  # 输出: MyApp v1

---

高级示例

5. 沙箱模式（能力控制）

from kossjs_interface import KossJS

# 纯计算沙箱 — 无 FS / 网络 / 加密
with KossJS(capabilities=KossJS.KOSS_CAP_SANDBOX) as koss:
    result = koss.eval("1 + 2 * 3")
    print(result)  # 输出: 7

# 只允许网络 + 加密
with KossJS(capabilities=KossJS.KOSS_CAP_NET | KossJS.KOSS_CAP_CRYPTO) as koss:
    result = koss.run_async("""
    (async () => {
        const r = await fetch("https://api.github.com/users/github");
        const d = await r.json();
        return d.login;
    })();
    """)
    print(result)

6. 并行执行（多实例）

NOTE

Worker 线程池自 v0.1.0-dev.10 起已移除。需要并行执行任务时，请在宿主侧创建多个实例，或用 run_async 处理异步任务。

from kossjs_interface import KossJS

# 并行执行多个独立任务（宿主侧管理）
def run(code):
    koss = KossJS()
    try:
        return koss.eval(code)
    finally:
        koss.destroy()

import concurrent.futures
with concurrent.futures.ThreadPoolExecutor(max_workers=2) as pool:
    results = pool.map(run, [
        "let s=0; for(let i=0;i<1000;i++) s+=i; s;",
        "6 * 7",
    ])
    for r in results:
        print(f"Result: {r}")

7. 注册原生类

from kossjs_interface import KossJS

def greet(name="World"):
    return f"Hello, {name}!"

koss = KossJS()
koss.register_class("Greeter", {"greet": greet})

result = koss.eval("new Greeter().greet('KossJS')")
print(result)  # 输出: Hello, KossJS!
koss.destroy()

---

更多示例请查看各语言接口文档。