Class Parser

Index

Constructors

Methods

getIncludedRanges getLanguage getLogger getTimeoutMicros parse printDotGraphs reset setLanguage setLogger setTimeoutMicros

Constructors

constructor

new Parser(): Parser
Returns Parser

Methods

getIncludedRanges

getIncludedRanges(): Range[]
Get the ranges of text that the parser will include when parsing.

Returns Range[]
An array of ranges that will be included in parsing
- Defined in tree-sitter.d.ts:33

getLanguage

getLanguage(): Language
Get the parser's current language

Returns Language
- Defined in tree-sitter.d.ts:66

getLogger

getLogger(): Logger
Get the parser's current logger

Returns Logger
The current logging callback
- Defined in tree-sitter.d.ts:84

getTimeoutMicros

getTimeoutMicros(): number
Get the duration in microseconds that parsing is allowed to take.

This timeout can be set via Parser.setTimeoutMicros.

Returns number
The parsing timeout in microseconds
- Defined in tree-sitter.d.ts:42

parse

parse(input: string | Input, oldTree?: Tree, options?: Options): Tree
Parse UTF8 text into a syntax tree.
Parameters
- input: string | Input
  The text to parse, either as a string or a custom input function that provides text chunks. If providing a function, it should return text chunks based on byte index and position.
- OptionaloldTree: Tree
  An optional previous syntax tree from the same document. If provided and the document has changed, you must first edit this tree using Parser.Tree.edit to match the new text.
- Optionaloptions: Options
  Optional parsing settings:
  - bufferSize: Size of internal parsing buffer
  - includedRanges: Array of ranges to parse within the input
Returns Tree
A syntax tree representing the parsed text
Throws
May return null or fail if:
- No language has been set via Parser.setLanguage
- The parsing timeout (set via Parser.setTimeoutMicros) was reached
- Parsing was cancelled via cancellation flag
- Defined in tree-sitter.d.ts:26

printDotGraphs

printDotGraphs(enabled?: boolean, fd?: number): void
Set the destination to which the parser should write debugging graphs during parsing.

The graphs are formatted in the DOT language. You may want to pipe these graphs directly to a 'dot' process to generate SVG output.
Parameters
- Optionalenabled: boolean
  Whether to enable or disable graph output
- Optionalfd: number
  Optional file descriptor for the output
Returns void
- Defined in tree-sitter.d.ts:102

reset

reset(): void
Instruct the parser to start the next parse from the beginning.

If the parser previously failed because of a timeout or cancellation, it will resume where it left off on the next parse by default. Call this method if you want to parse a different document instead of resuming.

Returns void
- Defined in tree-sitter.d.ts:61

setLanguage

setLanguage(language?: Language): void
Set the language that the parser should use for parsing.

The language must be compatible with the version of tree-sitter being used. A version mismatch will prevent the language from being assigned successfully.
Parameters
- Optionallanguage: Language
  The language to use for parsing
Returns void
- Defined in tree-sitter.d.ts:77

setLogger

setLogger(logFunc?: string | false | Logger): void
Set the logging callback that the parser should use during parsing.
Parameters
- OptionallogFunc: string | false | Logger
  The logging callback to use, or null/false to disable logging
Returns void
- Defined in tree-sitter.d.ts:91

setTimeoutMicros

setTimeoutMicros(timeout: number): void
Set the maximum duration that parsing is allowed to take before halting.

If parsing takes longer than this, it will halt early, returning null.
Parameters
- timeout: number
  The maximum parsing duration in microseconds
Returns void
- Defined in tree-sitter.d.ts:51