Acorn-JSX
This is plugin for Acorn - a tiny, fast JavaScript parser, written completely in JavaScript.
It was created as an experimental alternative, faster React.js JSX parser. Later, it replaced the official parser and these days is used by many prominent development tools.
Transpiler
Please note that this tool only parses source code to JSX AST, which
is useful for various language tools and services. If you want to
transpile your code to regular ES5-compliant JavaScript with source map,
check out Babel and Buble transpilers which use
acorn-jsx
under the hood.
Usage
Requiring this module provides you with an Acorn plugin that you can use like this:
var acorn = require("acorn");
var jsx = require("acorn-jsx");
.Parser.extend(jsx()).parse("my(<jsx/>, 'code');"); acorn
Note that official spec doesn’t support mix of XML namespaces and
object-style access in tag names (#27) like in
<namespace:Object.Property />
, so it was deprecated
in acorn-jsx@3.0
. If you still want to opt-in to support of
such constructions, you can pass the following option:
.Parser.extend(jsx({ allowNamespacedObjects: true })) acorn
Also, since most apps use pure React transformer, a new option was introduced that allows to prohibit namespaces completely:
.Parser.extend(jsx({ allowNamespaces: false })) acorn
Note that by default allowNamespaces
is enabled for spec
compliancy.
License
This plugin is issued under the MIT license.