index.js 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. // Acorn is a tiny, fast JavaScript parser written in JavaScript.
  2. //
  3. // Acorn was written by Marijn Haverbeke, Ingvar Stepanyan, and
  4. // various contributors and released under an MIT license.
  5. //
  6. // Git repositories for Acorn are available at
  7. //
  8. // http://marijnhaverbeke.nl/git/acorn
  9. // https://github.com/marijnh/acorn.git
  10. //
  11. // Please use the [github bug tracker][ghbt] to report issues.
  12. //
  13. // [ghbt]: https://github.com/marijnh/acorn/issues
  14. //
  15. // This file defines the main parser interface. The library also comes
  16. // with a [error-tolerant parser][dammit] and an
  17. // [abstract syntax tree walker][walk], defined in other files.
  18. //
  19. // [dammit]: acorn_loose.js
  20. // [walk]: util/walk.js
  21. import {Parser} from "./state"
  22. import {getOptions} from "./options"
  23. import "./parseutil"
  24. import "./statement"
  25. import "./lval"
  26. import "./expression"
  27. export {Parser, plugins} from "./state"
  28. export {defaultOptions} from "./options"
  29. export {SourceLocation} from "./location"
  30. export {getLineInfo} from "./location"
  31. export {Node} from "./node"
  32. export {TokenType, types as tokTypes} from "./tokentype"
  33. export {TokContext, types as tokContexts} from "./tokencontext"
  34. export {isIdentifierChar, isIdentifierStart} from "./identifier"
  35. export {Token} from "./tokenize"
  36. export {isNewLine, lineBreak, lineBreakG} from "./whitespace"
  37. export const version = "1.2.2"
  38. // The main exported interface (under `self.acorn` when in the
  39. // browser) is a `parse` function that takes a code string and
  40. // returns an abstract syntax tree as specified by [Mozilla parser
  41. // API][api].
  42. //
  43. // [api]: https://developer.mozilla.org/en-US/docs/SpiderMonkey/Parser_API
  44. export function parse(input, options) {
  45. let p = parser(options, input)
  46. let startPos = p.pos, startLoc = p.options.locations && p.curPosition()
  47. p.nextToken()
  48. return p.parseTopLevel(p.options.program || p.startNodeAt(startPos, startLoc))
  49. }
  50. // This function tries to parse a single expression at a given
  51. // offset in a string. Useful for parsing mixed-language formats
  52. // that embed JavaScript expressions.
  53. export function parseExpressionAt(input, pos, options) {
  54. let p = parser(options, input, pos)
  55. p.nextToken()
  56. return p.parseExpression()
  57. }
  58. // Acorn is organized as a tokenizer and a recursive-descent parser.
  59. // The `tokenize` export provides an interface to the tokenizer.
  60. export function tokenizer(input, options) {
  61. return parser(options, input)
  62. }
  63. function parser(options, input) {
  64. return new Parser(getOptions(options), String(input))
  65. }