Introducing swc 1.0 · swc


swc(speedy web compiler) is a super-fast javascript to javascript compiler.

What can swc do?

It can transpile typescript / jsx / ecmascript 2019 to browser-compatible javascript.

input.js:

class Foo { set foo(v) { }
}
class Bar extends Foo { get bar1() {} async bar2() {}
}

How fast is swc?

It's 16x - 20x faster than babel even on single-core synchronous benchmark. Note that actual performance gap is larger because swc works on worker thread while babel works on event loop thread.

Installation

You can install swc with

npm install --save-dev swc

or

yarn add --dev swc

See installation guide for more details.

What is included in swc 1.0.0?

Swc implements almost all babel plugins. As of 1.0.0, swc can understand various dialects of ecmascript and compiles them into es5.

ECMAScript 2019 support

.swcrc:

{ "jsc": { "parser": { "syntax": "ecmascript" } }
}

React (with jsx)

.swcrc:

{ "jsc": { "parser": { "syntax": "ecmascript", "jsc": true } }
}

Typescript support

Swc can also compile typescript / tsx to ecmascript. Note that it does not type-check at the time of writing. Type checking is tracked at #126.

.swcrc:

{ "jsc": { "parser": { "syntax": "typescript", "tsx": false } }
}

See docs for more details.

Various transforms

  • es3

    • member-expression-literals
    • property-literals
    • reserved-words
  • es2015

    • arrow-functions
    • block-scoped-functions
    • block-scoping
    • classes
    • computed-properties
    • destructuring
    • duplicate-keys
    • for-of
    • function-name
    • instanceof
    • literals
    • new-target
    • parameters
    • shorthand-properties
    • spread
    • sticky regex (y flag)
    • template-literals
    • typeof-symbol
  • es2016

  • es2017

  • es2018

  • react

Migrating from babel

@babel/core

Run npm i --save-dev swc or yarn add --dev swc.

Swc enables all passes by default. So if you are using only standartd ecmascript, you can just delete .babelrc and change babel.transform() to swc.transform().

See usage docs and migration docs for more details. Also note that swc does not support custom plugin yet.

@babel/cli

Run npm i --save-dev swc swc-cli or yarn add --dev swc swc-cli to install. CLI apis of swc-cli is almost equivalent to it of @babel/cli. So if you are using standartd ecmascript, you can just replace npx babel to npx swc. If it results in an error, please report an error.

See usage docs and migration docs for more details. Also note that swc does not support custom plugin yet.