Rust ECMAScript 2022兼容性库swc_ecma_compat_es2022的使用，为JavaScript代码提供ES2022语法转换和兼容性支持

安装

在项目目录中运行以下Cargo命令：

cargo add swc_ecma_compat_es2022

或者在Cargo.toml中添加以下行：

swc_ecma_compat_es2022 = "26.0.0"

使用示例

下面是一个完整的示例，展示如何使用swc_ecma_compat_es2022库将ES2022代码转换为兼容性更好的JavaScript代码：

use swc_common::{sync::Lrc, SourceMap};
use swc_ecma_compat_es2022::es2022;
use swc_ecma_parser::{lexer::Lexer, Parser, StringInput, Syntax};
use swc_ecma_transforms_base::helpers;
use swc_ecma_visit::FoldWith;

fn main() {
    // 创建源代码映射
    let cm = Lrc::<SourceMap>::default();
    
    // 要转换的ES2022代码
    let code = r#"
        class MyClass {
            #privateField = 42;
            
            static #privateStaticField = "hello";
            
            #privateMethod() {
                return this.#privateField;
            }
            
            static #privateStaticMethod() {
                return this.#privateStaticField;
            }
            
            publicMethod() {
                return this.#privateMethod();
            }
        }
        
        const obj = {
            a: 1,
            b: 2,
            c: 3,
            d() {
                return this.a + this.b + this.c;
            }
        };
        
        const { a, b, ...rest } = obj;
        const arr = [1, 2, 3];
        const [first, ...others] = arr;
    "#;
    
    // 创建词法分析器
    let lexer = Lexer::new(
        Syntax::Es(Default::default()),
        Default::default(),
        StringInput::from(&*code),
        None,
    );
    
    // 创建解析器
    let mut parser = Parser::new_from(lexer);
    
    // 解析代码为AST
    let module = parser.parse_module().unwrap();
    
    // 应用ES2022兼容性转换
    let module = module.fold_with(&mut helpers::InjectHelpers);
    let module = module.fold_with(&mut es2022());
    
    // 打印转换后的代码
    let output = swc_ecma_codegen::Emitter {
        cfg: Default::default(),
        cm: cm.clone(),
        comments: None,
        wr: Box::new(swc_ecma_codegen::text_writer::JsWriter::new(
            cm.clone(),
            "\n",
            Box::new(Vec::new()),
            None,
        )),
    };
    
    output.emit_module(&module).unwrap();
    
    let output = String::from_utf8(output.wr.into_inner().into_inner()).unwrap();
    println!("转换后的代码:\n{}", output);
}

功能说明

swc_ecma_compat_es2022库提供了以下ES2022特性的转换支持：

1. 私有类字段和方法(#privateField, #privateMethod)
2. 静态私有类字段和方法(static #privateStaticField)
3. 对象解构与剩余属性(…rest)
4. 数组解构与剩余元素(…others)
5. 类静态块
6. 顶层await
7. 错误原因链(error.cause)
8. 数组和字符串的.at()方法
9. Object.hasOwn()方法
10. 正则表达式匹配索引

完整示例代码

use swc_common::{sync::Lrc, SourceMap};
use swc_ecma_compat_es2022::es2022;
use swc_ecma_parser::{lexer::Lexer, Parser, StringInput, Syntax};
use swc_ecma_transforms_base::helpers;
use swc_ecma_visit::FoldWith;

fn main() {
    // 初始化源代码映射
    let cm: Lrc<SourceMap> = Lrc::default();
    
    // 定义要转换的ES2022代码
    let es2022_code = r#"
        // 类私有字段示例
        class Example {
            #privateValue = "secret";
            
            getPrivateValue() {
                return this.#privateValue;
            }
        }
        
        // 顶层await示例
        const data = await fetchData();
        
        // 类静态块示例
        class C {
            static x;
            static y;
            
            static {
                try {
                    this.x = doSomething();
                    this.y = this.x * 2;
                } catch {
                    this.x = 0;
                    this.y = 0;
                }
            }
        }
        
        // 错误原因链示例
        throw new Error('Something went wrong', {
            cause: new Error('Original error')
        });
    "#;
    
    // 创建词法分析器
    let lexer = Lexer::new(
        // 使用ES语法
        Syntax::Es(Default::default()),
        // 默认ECMAScript版本
        Default::default(),
        // 输入源代码
        StringInput::from(es2022_code),
        None,
    );
    
    // 创建解析器并解析为AST
    let mut parser = Parser::new_from(lexer);
    let module = parser.parse_module().expect("解析失败");
    
    // 应用转换：先注入帮助函数，再应用ES2022转换
    let transformed_module = module
        .fold_with(&mut helpers::InjectHelpers)
        .fold_with(&mut es2022());
    
    // 配置代码生成器
    let mut buf = Vec::new();
    let emitter = swc_ecma_codegen::Emitter {
        cfg: Default::default(),
        cm: cm.clone(),
        comments: None,
        wr: Box::new(swc_ecma_codegen::text_writer::JsWriter::new(
            cm,
            "\n",
            Box::new(buf),
            None,
        )),
    };
    
    // 生成转换后的代码
    emitter.emit_module(&transformed_module).expect("代码生成失败");
    let output_code = String::from_utf8(buf).expect("无效的UTF-8输出");
    
    println!("转换结果:");
    println!("{}", output_code);
}

许可证

Apache-2.0