espree.js 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177
  1. /**
  2. * @fileoverview Main Espree file that converts Acorn into Esprima output.
  3. *
  4. * This file contains code from the following MIT-licensed projects:
  5. * 1. Acorn
  6. * 2. Babylon
  7. * 3. Babel-ESLint
  8. *
  9. * This file also contains code from Esprima, which is BSD licensed.
  10. *
  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>
  14. *
  15. * Redistribution and use in source and binary forms, with or without
  16. * modification, are permitted provided that the following conditions are met:
  17. *
  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.
  23. *
  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.
  34. *
  35. * Esprima is Copyright (c) jQuery Foundation, Inc. and Contributors, All Rights Reserved.
  36. *
  37. * Redistribution and use in source and binary forms, with or without
  38. * modification, are permitted provided that the following conditions are met:
  39. *
  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.
  45. *
  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.
  56. */
  57. /* eslint no-undefined:0, no-use-before-define: 0 */
  58. "use strict";
  59. const acorn = require("acorn");
  60. const jsx = require("acorn-jsx");
  61. const astNodeTypes = require("./lib/ast-node-types");
  62. const espree = require("./lib/espree");
  63. const { getLatestEcmaVersion, getSupportedEcmaVersions } = require("./lib/options");
  64. // To initialize lazily.
  65. const parsers = {
  66. _regular: null,
  67. _jsx: null,
  68. get regular() {
  69. if (this._regular === null) {
  70. this._regular = acorn.Parser.extend(espree());
  71. }
  72. return this._regular;
  73. },
  74. get jsx() {
  75. if (this._jsx === null) {
  76. this._jsx = acorn.Parser.extend(jsx(), espree());
  77. }
  78. return this._jsx;
  79. },
  80. get(options) {
  81. const useJsx = Boolean(
  82. options &&
  83. options.ecmaFeatures &&
  84. options.ecmaFeatures.jsx
  85. );
  86. return useJsx ? this.jsx : this.regular;
  87. }
  88. };
  89. //------------------------------------------------------------------------------
  90. // Tokenizer
  91. //------------------------------------------------------------------------------
  92. /**
  93. * Tokenizes the given code.
  94. * @param {string} code The code to tokenize.
  95. * @param {Object} options Options defining how to tokenize.
  96. * @returns {Token[]} An array of tokens.
  97. * @throws {SyntaxError} If the input code is invalid.
  98. * @private
  99. */
  100. function tokenize(code, options) {
  101. const Parser = parsers.get(options);
  102. // Ensure to collect tokens.
  103. if (!options || options.tokens !== true) {
  104. options = Object.assign({}, options, { tokens: true }); // eslint-disable-line no-param-reassign
  105. }
  106. return new Parser(options, code).tokenize();
  107. }
  108. //------------------------------------------------------------------------------
  109. // Parser
  110. //------------------------------------------------------------------------------
  111. /**
  112. * Parses the given code.
  113. * @param {string} code The code to tokenize.
  114. * @param {Object} options Options defining how to tokenize.
  115. * @returns {ASTNode} The "Program" AST node.
  116. * @throws {SyntaxError} If the input code is invalid.
  117. */
  118. function parse(code, options) {
  119. const Parser = parsers.get(options);
  120. return new Parser(options, code).parse();
  121. }
  122. //------------------------------------------------------------------------------
  123. // Public
  124. //------------------------------------------------------------------------------
  125. exports.version = require("./package.json").version;
  126. exports.tokenize = tokenize;
  127. exports.parse = parse;
  128. // Deep copy.
  129. /* istanbul ignore next */
  130. exports.Syntax = (function() {
  131. let name,
  132. types = {};
  133. if (typeof Object.create === "function") {
  134. types = Object.create(null);
  135. }
  136. for (name in astNodeTypes) {
  137. if (Object.hasOwnProperty.call(astNodeTypes, name)) {
  138. types[name] = astNodeTypes[name];
  139. }
  140. }
  141. if (typeof Object.freeze === "function") {
  142. Object.freeze(types);
  143. }
  144. return types;
  145. }());
  146. /* istanbul ignore next */
  147. exports.VisitorKeys = (function() {
  148. return require("eslint-visitor-keys").KEYS;
  149. }());
  150. exports.latestEcmaVersion = getLatestEcmaVersion();
  151. exports.supportedEcmaVersions = getSupportedEcmaVersions();