Skip to content

Error Reference

Error Reference

All error types thrown by the library across all languages.

Error

Errors that can occur when using the tree-sitter language pack.

Covers language lookup failures, parse errors, query errors, and I/O issues. Feature-gated variants are included when config, download, or related features are enabled.

Variant Message Description
LanguageNotFound Language '{0}' not found The requested language name (or alias) was not found in the registry.
DynamicLoad Dynamic library load error: A dynamic shared library could not be loaded at runtime.
NullLanguagePointer Language function returned null pointer for '{0}' The tree-sitter language function returned a null pointer for the given language name.
ParserSetup Failed to set parser language: The language could not be applied to the parser (e.g., ABI version mismatch).
LockPoisoned Registry lock poisoned: An internal RwLock or Mutex was poisoned by a previous panic.
Config Configuration error: A configuration file or value was invalid or could not be applied.
ParseFailed Parse failed: parsing returned no tree The tree-sitter parser returned no tree for the given source input.
QueryError Query error: A tree-sitter query could not be compiled or executed.
InvalidRange Invalid byte range: A byte range was invalid (e.g., end before start, or out of bounds).
Download Download error: A parser download from GitHub releases failed.
ChecksumMismatch Checksum mismatch for '{file}': expected {expected}, got {actual} The downloaded file's SHA-256 digest did not match the manifest's expected value.
CacheLock Download cache lock error: The cross-process download cache lock file could not be acquired or created.

Edit this page on GitHub