2 * @fileoverview Main Espree file that converts Acorn into Esprima output.
4 * This file contains code from the following MIT-licensed projects:
9 * This file also contains code from Esprima, which is BSD licensed.
11 * Acorn is Copyright 2012-2015 Acorn Contributors (https://github.com/marijnh/acorn/blob/master/AUTHORS)
12 * Babylon is Copyright 2014-2015 various contributors (https://github.com/babel/babel/blob/master/packages/babylon/AUTHORS)
13 * Babel-ESLint is Copyright 2014-2015 Sebastian McKenzie <sebmck@gmail.com>
15 * Redistribution and use in source and binary forms, with or without
16 * modification, are permitted provided that the following conditions are met:
18 * * Redistributions of source code must retain the above copyright
19 * notice, this list of conditions and the following disclaimer.
20 * * Redistributions in binary form must reproduce the above copyright
21 * notice, this list of conditions and the following disclaimer in the
22 * documentation and/or other materials provided with the distribution.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
28 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
29 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
31 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
32 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
33 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 * Esprima is Copyright (c) jQuery Foundation, Inc. and Contributors, All Rights Reserved.
37 * Redistribution and use in source and binary forms, with or without
38 * modification, are permitted provided that the following conditions are met:
40 * * Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * * Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in the
44 * documentation and/or other materials provided with the distribution.
46 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
47 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
48 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
49 * ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
50 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
51 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
52 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
53 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
54 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
55 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
57 /* eslint no-undefined:0, no-use-before-define: 0 */
61 const acorn = require("acorn");
62 const jsx = require("acorn-jsx");
63 const astNodeTypes = require("./lib/ast-node-types");
64 const espree = require("./lib/espree");
65 const { getLatestEcmaVersion, getSupportedEcmaVersions } = require("./lib/options");
67 // To initialize lazily.
73 if (this._regular === null) {
74 this._regular = acorn.Parser.extend(espree());
80 if (this._jsx === null) {
81 this._jsx = acorn.Parser.extend(jsx(), espree());
87 const useJsx = Boolean(
89 options.ecmaFeatures &&
90 options.ecmaFeatures.jsx
93 return useJsx ? this.jsx : this.regular;
97 //------------------------------------------------------------------------------
99 //------------------------------------------------------------------------------
102 * Tokenizes the given code.
103 * @param {string} code The code to tokenize.
104 * @param {Object} options Options defining how to tokenize.
105 * @returns {Token[]} An array of tokens.
106 * @throws {SyntaxError} If the input code is invalid.
109 function tokenize(code, options) {
110 const Parser = parsers.get(options);
112 // Ensure to collect tokens.
113 if (!options || options.tokens !== true) {
114 options = Object.assign({}, options, { tokens: true }); // eslint-disable-line no-param-reassign
117 return new Parser(options, code).tokenize();
120 //------------------------------------------------------------------------------
122 //------------------------------------------------------------------------------
125 * Parses the given code.
126 * @param {string} code The code to tokenize.
127 * @param {Object} options Options defining how to tokenize.
128 * @returns {ASTNode} The "Program" AST node.
129 * @throws {SyntaxError} If the input code is invalid.
131 function parse(code, options) {
132 const Parser = parsers.get(options);
134 return new Parser(options, code).parse();
137 //------------------------------------------------------------------------------
139 //------------------------------------------------------------------------------
141 exports.version = require("./package.json").version;
143 exports.tokenize = tokenize;
145 exports.parse = parse;
148 /* istanbul ignore next */
149 exports.Syntax = (function() {
153 if (typeof Object.create === "function") {
154 types = Object.create(null);
157 for (name in astNodeTypes) {
158 if (Object.hasOwnProperty.call(astNodeTypes, name)) {
159 types[name] = astNodeTypes[name];
163 if (typeof Object.freeze === "function") {
164 Object.freeze(types);
170 /* istanbul ignore next */
171 exports.VisitorKeys = (function() {
172 return require("eslint-visitor-keys").KEYS;
175 exports.latestEcmaVersion = getLatestEcmaVersion();
177 exports.supportedEcmaVersions = getSupportedEcmaVersions();