WPS Office办公软件从VBA开发转向JS开发(JSA)的注意事项

WPS Office办公软件从VBA开发转向JS开发(JSA)的注意事项

在将WPS Office办公软件的开发从VBA（Visual Basic for Applications）转向JS（JavaScript）开发（JSA）时，开发者需要注意以下几个关键方面：

一、JSAPI接口的差异

1. 方法的差异

   括号使用：在VBA中，方法调用可以不加括号，但在JSAPI中，所有方法都需要加括号。例如，Application.Workbooks(1).Close 在JSAPI中应写为 Application.Workbooks.Item(1).Close()。

   参数赋值：VBA支持给部分参数赋值，而JS则需要用undefined占位补齐缺省的参数。例如，Range("A1:N29").Find("香港特别", LookIn:=xlValues).Select 在JSAPI中应写为 Application.ActiveSheet.Range("A1:N29").Find("我", undefined, xlValues).Select();。

   集合对象获取：在VBA中，可以通过数组方式取集合中的对象，而在JSAPI中，必须通过Item方法获取。此外，二维数组取值时，VBA使用.value，而JSAPI使用.Value2。

2. 属性的差异

   错误处理：在VBA中，调用书写错误的属性会报错，但在JSAPI中，调用不存在的属性不会报错，这可能导致潜在的bug。因此，开发者需要特别注意属性的正确性。

   对象替代：VBA支持ThisDocument对象，但JSAPI暂时不支持，可以用ActiveDocument代替。

3. 事件的差异

   JSAPI支持的事件基本与VBA一致，但某些特定的事件或功能可能有所不同。开发者在转换时需要特别注意事件的触发条件和参数。

二、函数定义

• VBA使用Sub ... End Sub关键字定义函数，而JS使用function{}关键字定义。例如，Public(Private) Sub AddTemplate() 在JS中应写为 function AddTemplate() {}。

三、数据类型

• VBA在数据定义时需要指明类型，但JS是动态类型，赋值后才有类型。
• JS包括的基本类型有字符串（String）、数字(Number)、布尔(Boolean)、对空（Null）、未定义（Undefined）、Symbol。
• VBA的Boolean类型首字母大写，而JS中都是小写。
• JS字符串使用反斜杠“”作为转义字符，文件路径应使用“/”或“”(Windows)作为路径分隔符。

四、运算符

• 算术运算符：VBA中的Mod关键字在JS中应改为%。
• 字符串拼接：在VBA中，可以使用&来拼接字符串，而在JS中，可以使用+。
• 逻辑运算符：VBA和JS的逻辑运算符有所不同，例如，VBA中的逻辑与为AND，逻辑或为OR，逻辑非为<>；而在JS中，逻辑与为&&，逻辑或为||，逻辑非为!。

五、枚举

• 在VBA中，枚举可以有两种写法，如wdAlignParagraphLeft和WdParagraphAlignment.wdAlignParagraphLeft，但在JSAPI中，只支持第一种写法。

六、With关键字

• VBA有With关键字，用于简化对同一对象的多次引用。但在JS中，没有With关键字，可以通过将对象赋值给一个变量来实现相同的效果。

七、条件语句

• VBA中的条件语句IF 条件 Then 表达式 Endif在JS中应转换为if(条件) {表达式}。

八、其他注意事项

• 窗体（UserForm）功能：目前JSAPI在窗体功能支持上还有一些坑，开发者在转换时需要特别注意。
• 跨平台兼容性：JSAPI的主要好处是可跨平台，可以在Linux的WPS上使用。但开发者在开发过程中需要测试在不同平台上的兼容性。
• 官方文档与社区支持：WPS Office提供了详细的JSAPI开发文档，开发者在遇到问题时可以查阅文档或寻求社区的帮助。

综上所述，从VBA开发转向JS开发需要开发者注意接口差异、函数定义、数据类型、运算符、枚举、With关键字、条件语句以及其他相关注意事项。通过仔细学习和实践，开发者可以顺利实现从VBA到JS的转换。