Struct swc::Compiler

pub struct Compiler {
    pub cm: Arc<SourceMap>,
    pub handler: Arc<Handler>,
    // some fields omitted
}

Fields

cm: Arc<SourceMap>

CodeMap

handler: Arc<Handler>

Implementations

impl Compiler

These are low-level apis.

pub fn globals(&self) -> &Globals

pub fn comments(&self) -> &SwcComments

pub fn run<R, F>(&self, op: F) -> R where
    F: FnOnce() -> R, 

Runs op in current compiler’s context.

Note: Other methods of Compiler already uses this internally.

pub fn parse_js(
    &self,
    fm: Arc<SourceFile>,
    target: JscTarget,
    syntax: Syntax,
    is_module: bool,
    parse_comments: bool
) -> Result<Program, Error>

This method parses a javascript / typescript file

pub fn print<T>(
    &self,
    node: &T,
    source_file_name: Option<&str>,
    output_path: Option<PathBuf>,
    target: JscTarget,
    source_map: SourceMapsConfig,
    orig: Option<&SourceMap>,
    minify: bool
) -> Result<TransformOutput, Error> where
    T: Node, 

Converts ast node to source string and sourcemap.

This method receives target file path, but does not write file to the path. See: https://github.com/swc-project/swc/issues/1255

impl Compiler

High-level apis.

pub fn new(cm: Arc<SourceMap>, handler: Arc<Handler>) -> Self

pub fn read_config(
    &self,
    opts: &Options,
    name: &FileName
) -> Result<Option<Config>, Error>

pub fn config_for_file<'a>(
    &'a self,
    opts: &Options,
    name: &FileName
) -> Result<Option<BuiltConfig<impl 'a + Fold>>, Error>

This method returns None if a file should be skipped.

This method handles merging of config.

This method does not parse module.

pub fn run_transform<F, Ret>(&self, external_helpers: bool, op: F) -> Ret where
    F: FnOnce() -> Ret, 

pub fn transform(
    &self,
    program: Program,
    external_helpers: bool,
    pass: impl Fold
) -> Program

pub fn process_js_with_custom_pass<P>(
    &self,
    fm: Arc<SourceFile>,
    opts: &Options,
    custom_after_pass: P
) -> Result<TransformOutput, Error> where
    P: Fold, 

custom_after_pass is applied after swc transforms are applied.

pub fn process_js_file(
    &self,
    fm: Arc<SourceFile>,
    opts: &Options
) -> Result<TransformOutput, Error>

pub fn minify(
    &self,
    fm: Arc<SourceFile>,
    opts: &JsMinifyOptions
) -> Result<TransformOutput, Error>

pub fn process_js(
    &self,
    program: Program,
    opts: &Options
) -> Result<TransformOutput, Error>

You can use custom pass with this method.

There exists a PassBuilder to help building custom passes.