在ClearScript中正确传递JavaScript对象给Turf.js库的方法

问题背景

在使用ClearScript这个强大的.NET与JavaScript互操作库时，开发者经常需要将C#对象传递给JavaScript函数。然而，当使用Turf.js这样的地理空间处理库时，直接传递.NET对象可能会导致错误，因为Turf.js期望接收的是原生的JavaScript对象。

核心问题分析

Turf.js的bbox方法要求传入的参数必须是一个符合GeoJSON标准的JavaScript对象。当开发者尝试以下两种方式时都会失败：

1. 传递JSON字符串：虽然JSON.stringify可以将对象序列化为字符串，但Turf.js需要的是对象本身而非字符串表示
2. 传递.NET字典对象：ClearScript不会自动将.NET字典转换为JavaScript对象

解决方案详解

ClearScript的设计理念是不在.NET和JavaScript之间自动转换对象和数组，因为这种转换可能会导致数据丢失。因此，我们需要在.NET端构造真正的JavaScript对象。

构建JavaScript对象的工具方法

首先，我们需要在脚本引擎中创建两个辅助函数：

// 创建JavaScript对象的工厂函数
dynamic newObject = Engine.Evaluate("() => ({})");

// 创建JavaScript数组的工厂函数
dynamic newArray = Engine.Evaluate("(function () { return [...arguments]; })");

构造Turf.js所需的GeoJSON对象

有了上述工具后，我们可以按照GeoJSON规范构建多边形对象：

// 创建基础对象
var geoJsonObj = newObject();

// 设置类型为多边形
geoJsonObj.type = "Polygon";

// 构建坐标数组
geoJsonObj.coordinates = newArray(
    newArray(
        newArray(108.3772586426722, 22.811010986889986),
        newArray(108.37827566589279, 22.815062279607343),
        newArray(108.37754916500549, 22.815444906122217),
        newArray(108.37642578209547, 22.81427829606639),
        newArray(108.3754340489081, 22.811905891718265),
        newArray(108.37544099548577, 22.811001924694395),
        newArray(108.3750624387526, 22.807459337499285),
        newArray(108.3750624387526, 22.807459337499285),
        newArray(108.37684873041493, 22.80836068823839),
        newArray(108.3772586426722, 22.811010986889986)
    )
);

调用Turf.js方法

构造好正确的JavaScript对象后，就可以安全地调用Turf.js的bbox方法了：

var boundingBox = Engine.Script.turf.bbox(geoJsonObj);
Console.WriteLine($"边界框结果: {boundingBox.toString()}");

技术要点总结

1. 对象类型一致性：Turf.js等JavaScript库通常需要原生的JavaScript对象，不能接受JSON字符串或.NET对象
2. ClearScript设计原则：ClearScript有意不自动转换对象和数组，以保持数据完整性
3. 构造原生对象：通过Evaluate方法创建JavaScript对象工厂是推荐做法
4. GeoJSON规范：构建地理空间数据时，必须遵循GeoJSON的格式要求

最佳实践建议

1. 对于复杂的JavaScript对象，先在JavaScript环境中测试其结构，再在C#中模仿构建
2. 将对象构造逻辑封装为辅助方法，提高代码复用性
3. 注意坐标数据的精度和顺序，地理空间应用对此非常敏感
4. 考虑使用TypeScript类型定义来确保对象结构的正确性

通过这种方法，开发者可以在ClearScript环境中无缝使用Turf.js等专业JavaScript库，充分发挥.NET和JavaScript生态系统的优势。