Struct JavaScriptCompiler 

pub struct JavaScriptCompiler { /* private fields */ }

JavaScriptCompiler is a struct that represents a JavaScript compiler instance.

It holds the global configuration and a reference to the source map. You can use the JavaScript compiler to parse, transform, minify, and stringify JavaScript code.

Thanks to swc as lower tools, it is fast and efficient.

Implementations

impl JavaScriptCompiler

pub fn minify<S: Into<String>, F>( &self, filename: FileName, source: S, opts: JsMinifyOptions, comments_op: Option<F>, ) -> Result<TransformOutput, BatchErrors>

where F: for<'a> FnOnce(&'a SingleThreadedComments),

Minifies the given JavaScript source code.

This method takes a filename, the source code to minify, minification options, and an optional function to operate on comments. It returns a TransformOutput containing the minified code and an optional source map.

Parameters

• filename: The name of the file being minified.
• source: The source code to minify.
• opts: The options for minification.
• comments_op: An optional function to operate on the comments in the source code.

Returns

A Result containing a TransformOutput if the minification is successful, or a BatchErrors if an error occurs.

Examples found in repository

examples/minify.rs (lines 7-12)

fn main() {
  let source = "const a = 10;";

  let compiler = JavaScriptCompiler::new();
  let output = compiler.minify(
    swc_core::common::FileName::Custom("test.js".to_string()),
    source,
    Default::default(),
    None::<&dyn Fn(&swc_core::common::comments::SingleThreadedComments)>,
  );

  match output {
    Ok(o) => {
      println!("Minified output: {o:?}");
    }
    Err(err) => {
      let e = err
        .into_inner()
        .into_iter()
        .map(|e| format!("{e:?}"))
        .collect::<Vec<_>>()
        .join("\n");
      eprintln!("{e:?}");
    }
  }
}

impl JavaScriptCompiler

pub fn parse<S: Into<String>>( self, filename: FileName, source: S, target: EsVersion, syntax: Syntax, is_module: IsModule, comments: Option<SwcComments>, ) -> Result<Ast, BatchErrors>

Parses JavaScript source code into an AST.

This method takes the filename, source code, target ECMAScript version, syntax, module type, and optional comments. It returns a Result containing the parsed AST if successful, or a BatchErrors if an error occurs.

Parameters

• filename: The name of the file being parsed.
• source: The source code to parse.
• target: The target ECMAScript version.
• syntax: The syntax to use for parsing.
• is_module: Indicates if the source code is a module.
• comments: Optional comments to include in the parsing process.

Returns

A Result containing the parsed AST if successful, or a BatchErrors if an error occurs.

pub fn parse_with_lexer( self, fm: &SourceFile, lexer: Lexer<'_>, is_module: IsModule, comments: Option<SwcComments>, with_tokens: bool, ) -> Result<(Ast, Option<Vec<TokenAndSpan>>), BatchErrors>

pub fn parse_js( &self, fm: Arc<SourceFile>, target: EsVersion, syntax: Syntax, is_module: IsModule, comments: Option<&dyn Comments>, ) -> Result<SwcProgram, BatchErrors>

Parses JavaScript code from a source file into an SwcProgram.

impl JavaScriptCompiler

pub fn print( &self, node: &SwcProgram, options: PrintOptions<'_>, ) -> Result<TransformOutput>

impl JavaScriptCompiler

pub fn transform<'a, S, P>( &self, source: S, filename: Option<FileName>, options: SwcOptions, module_source_map_kind: Option<SourceMapKind>, inspect_parsed_ast: impl FnOnce(&Program, Mark), before_pass: impl FnOnce(&Program) -> P + 'a, ) -> Result<TransformOutput>

where P: Pass + 'a, S: Into<String>,

Transforms the given JavaScript source code according to the provided options and source map kind.

Examples found in repository

examples/transform.rs (lines 8-15)

fn main() {
  let source = "const a = 10;";

  let compiler = JavaScriptCompiler::new();
  let s = compiler.transform(
    source,
    Some(swc_core::common::FileName::Custom("test.js".to_string())),
    Default::default(),
    None,
    |_, _| {},
    |_| noop_pass(),
  );

  match s {
    Ok(output) => {
      println!("Transformed output: {output:?}");
    }
    Err(err) => {
      eprintln!("{err}");
    }
  }
}

impl JavaScriptCompiler

pub fn new() -> Self

Examples found in repository

examples/transform.rs (line 7)

fn main() {
  let source = "const a = 10;";

  let compiler = JavaScriptCompiler::new();
  let s = compiler.transform(
    source,
    Some(swc_core::common::FileName::Custom("test.js".to_string())),
    Default::default(),
    None,
    |_, _| {},
    |_| noop_pass(),
  );

  match s {
    Ok(output) => {
      println!("Transformed output: {output:?}");
    }
    Err(err) => {
      eprintln!("{err}");
    }
  }
}

examples/minify.rs (line 6)

fn main() {
  let source = "const a = 10;";

  let compiler = JavaScriptCompiler::new();
  let output = compiler.minify(
    swc_core::common::FileName::Custom("test.js".to_string()),
    source,
    Default::default(),
    None::<&dyn Fn(&swc_core::common::comments::SingleThreadedComments)>,
  );

  match output {
    Ok(o) => {
      println!("Minified output: {o:?}");
    }
    Err(err) => {
      let e = err
        .into_inner()
        .into_iter()
        .map(|e| format!("{e:?}"))
        .collect::<Vec<_>>()
        .join("\n");
      eprintln!("{e:?}");
    }
  }
}

Trait Implementations

impl Default for JavaScriptCompiler

fn default() -> JavaScriptCompiler

Returns the “default value” for a type.