flow-parser

The flow-parser package

This package contains the Flow parser in its compiled-to-JavaScript form.

What is Flow

See flow.org. The code for the Flow parser lives on GitHub.

What is the Flow Parser

The Flow Parser is a JavaScript parser written in OCaml. It produces an AST that conforms to the ESTree spec and that mostly matches what esprima produces. The Flow Parser can be compiled to native code or can be compiled to JavaScript using js_of_ocaml. This npm package contains the Flow parser compiled to JavaScript.

Usage

You can use the Flow parser in your browser or in node. To use in node you can just do

require('flow-parser').parse('1+1', {});

To use in the browser, you can add

<script src="flow_parser.js"></script>

which will make the flow object available to use like so:

flow.parse('1+1', {});

Options

The second argument to flow.parse is the options object. Currently supported options:

Basic options

• types (boolean, default true) - enable parsing of Flow types
• use_strict (boolean, default false) - treat the file as strict, without needing a "use strict" directive
• comments (boolean, default true) - attach comments to AST nodes (leadingComments and trailingComments)
• all_comments (boolean, default true) - include a list of all comments from the whole program
• tokens (boolean, default false) - include a list of all parsed tokens in a top-level tokens property

Language features

• enums (boolean, default false) - enable parsing of enums
• match (boolean, default false) - enable parsing of match expressions and match statements
• components (boolean, default false) - enable parsing of component syntax
• assert_operator (boolean, default false) - enable parsing of the assert operator
• esproposal_decorators (boolean, default false) - enable parsing of decorators

Similar packages

Other packages similar to flow-parser

acorn

Acorn is a small, fast, JavaScript-based JavaScript parser that produces an AST. It is used by various tools within the JavaScript ecosystem. Acorn is highly extensible through plugins and can handle modern JavaScript syntax. While flow-parser is specific to Flow type annotations, Acorn is more general-purpose and does not have built-in support for Flow types.

typescript-eslint-parser

typescript-eslint-parser is a parser that allows ESLint to lint TypeScript code. It converts TypeScript into an ESTree-compatible form so it can be used in the existing ESLint ecosystem. Unlike flow-parser, which is specific to Flow, typescript-eslint-parser is designed to work with TypeScript and can be used to enforce TypeScript-specific linting rules.